BoozeButler Documentation

Getting Started

Creating an Account

To use BoozeButler, you'll need to create an account:

1. Click Get started or Register from the landing page
2. Enter your email address and create a password (minimum 8 characters)
3. Check your email for a welcome message
4. Log in to access the app

First Time Setup - Taste Quiz

When you first log in, you'll complete a quick 4-question taste quiz to help BoozeButler understand your preferences:

1. Favorite Spirits - Select the spirits you enjoy most
2. Sweetness Preference - Choose your preferred sweetness level (Dry, Balanced, or Sweet)
3. Strength Preference - Select your preferred drink strength (Low ABV, Balanced, or Bold/Spirit-forward)
4. Adventurousness - Indicate how adventurous you are with new flavors and techniques

This quiz sets your baseline preferences. BoozeButler will continue learning from your likes, dislikes, and the drinks you make to improve recommendations over time.

Installing the App (PWA)

BoozeButler is a Progressive Web App (PWA), which means you can install it on your device:

• Desktop (Chrome/Edge): Look for the install icon in the address bar, or click the "Install app" button in the header
• iOS Safari: Tap Share → "Add to Home Screen"
• Android Chrome: Tap menu → "Install app" or "Add to Home Screen"

Once installed, the app works offline and provides a native app-like experience.

Managing Inventory

Adding Items Manually

To add bottles and bar items manually:

1. Go to the Inventory tab
2. Fill in the form with:
   • Name: The spirit or item name (e.g., "Bourbon")
   • Type: Select from spirit, liqueur, syrup, juice, bitters, mixer, garnish, etc.
   • Brand: Optional brand name (e.g., "Woodford Reserve")
   • Tags: Comma-separated tags (e.g., "whiskey, bourbon, aged")
3. Click Add/Update

Scanning Bottles

On supported devices, you can scan your bar shelves:

1. Click Scan bottles (camera) in the Inventory tab
2. Take 2-3 photos per shelf in good lighting
3. Review the detected bottles
4. Select the items you want to add and click Add Selected

Note: Photo scanning is currently available on localhost/development. Production scanning coming soon.

Marking Items Out of Stock

To mark an item as out of stock, add the tag out or out-of-stock to the item. This helps BoozeButler:

• Exclude unavailable items from recommendations
• Include them in shopping list suggestions

Personalization

BoozeButler learns your preferences to provide personalized recommendations. Here's how it works:

Initial Setup

The 4-question taste quiz you complete during onboarding sets your baseline preferences. This gives BoozeButler a starting point to understand your taste profile.

How BoozeButler Learns

After the initial quiz, BoozeButler continues learning from:

• Likes and Dislikes: When you like or dislike a recipe, BoozeButler adjusts future recommendations
• What You Make: The drinks you actually make and serve help BoozeButler understand your preferences better
• Feedback: Any feedback you provide on recipes influences future suggestions

The more you use BoozeButler, the better it understands your preferences and the more personalized your recommendations become.

Builders

BoozeButler offers several AI-powered builders to help you create the perfect drinks. Each builder is designed for different use cases:

Make a Drink

Purpose: Generate a single cocktail recommendation based on your inventory and preferences.

Use Make a Drink when you want:

• A quick single cocktail idea
• To use specific bottles from your inventory
• Personalized recommendations based on your taste profile

How to use:

1. Navigate to Make a Drink
2. Optionally select base spirits or highlight a specific bottle
3. Set your mood, flavor preferences, and occasion
4. Click Get a drink idea

Round Builder

Purpose: Create a curated 3-drink flight with variety and anti-repetition.

Round Builder generates three drinks designed to work together:

• Opener: The first drink to start the experience
• Centerpiece: The main featured drink
• Closer: The final drink to complete the round

The builder ensures variety across the three drinks, avoiding repetition of ingredients, flavors, or styles. Perfect for hosting or creating a complete tasting experience.

How to use:

1. Navigate to Round Builder
2. Set your mood, occasion, and flavor preferences
3. Optionally choose style presets for quick configuration
4. Click Build Round to generate your 3-drink flight

Mocktail Builder

Purpose: Create sophisticated non-alcoholic cocktails.

Mocktail Builder helps you craft zero-proof drinks that are just as complex and interesting as their alcoholic counterparts. Perfect for:

• Designated drivers
• Anyone who doesn't drink alcohol
• Low-ABV or alcohol-free occasions
• Creating inclusive drink menus

How to use:

1. Navigate to Mocktail Builder
2. Set your flavor preferences and occasion
3. Select from your non-alcoholic inventory items
4. Click Build Mocktail to generate your recipe

AI Bartender

Purpose: Conversational cocktail recommendations and advice.

AI Bartender is a chat-based interface where you can have a conversation about what you want to drink. Ask questions, describe what you're in the mood for, or get recommendations through natural conversation.

How to use:

1. Navigate to AI Bartender
2. Start a conversation by describing what you want
3. Ask follow-up questions or refine your preferences
4. The AI will provide recommendations and answer questions about cocktails

TikTok Studio (Pro Feature)

Purpose: Create shareable recipe cards and content for social media.

TikTok Studio helps you turn your favorite recipes into beautiful, shareable content for TikTok and other social platforms. Customize the style, theme, and formatting to match your brand.

Features:

• Customizable recipe card designs
• Multiple style themes
• Export options for social media
• Brand customization

Note: TikTok Studio is available for Pro subscribers. Upgrade to Pro to access this feature.

How to use:

1. Navigate to TikTok Studio (Pro required)
2. Select a recipe from your library or create a new one
3. Customize the design, theme, and formatting
4. Export or share your recipe card

Saving and Managing Recipes

From any builder result, you can:

• Mark as favorite - Save to your favorites list
• Save to library - Add to your recipe collection for future reference
• Share - Share recipes with others

Planner

Settings

User Account

• Email: Your account email address
• Logout: Sign out and return to the login page

Change Password

1. Enter your current password
2. Enter your new password (minimum 8 characters)
3. Confirm your new password
4. Click Change Password

Theme & Lighting

Customize the app appearance:

• Theme: Switch between BoozeButler theme (copper) and Halytic theme (blue)
• Lights: Toggle between light and dark mode

Your preferences are saved and persist across sessions.

Tips & Tricks

Data Sync

Your inventory, preferences, and settings automatically sync across all your devices. Add items on your phone, use them on your tablet!

Offline Usage

BoozeButler works offline for:

• Viewing your inventory
• Accessing saved recipes from your library
• Viewing favorites

AI-powered builders require an internet connection to generate new recommendations.

Keyboard Shortcuts

Use keyboard shortcuts for faster navigation (if supported by your browser).

Refreshing the App

If you notice stale data or outdated assets, click the refresh button (↻) in the header to force an update.

Getting Help

If you encounter issues:

• Check that you're logged in
• Try refreshing the app
• Clear your browser cache if needed
• Contact support if problems persist