📚 Booze & Books — User Documentation

Learn how to get started, add books, swap with others, chat, generate cocktail ideas, and manage notifications.

For help or troubleshooting, reach out to sahil.mb@gmail.com.

Introduction

Booze & Books helps you discover books, swap with other readers, and enjoy cocktail ideas inspired by your literary journey. Manage your collection, coordinate swaps, chat with partners, and find nearby stores—all in one place.

  • Discover and add books to your library.
  • Request, accept, decline, or counter swap offers.
  • Chat with your swap partner to coordinate logistics.
  • Generate cocktail ideas and find nearby stores for ingredients.
  • Stay informed with in-product and email notifications.

Getting Started

Create an account

  1. Go to Sign Up.
  2. Create an account with email and password, or use Google sign-in if enabled.
  3. After signing up, you’ll be directed to your dashboard.

Sign in and out

  • Sign in at Sign In.
  • Sign out from the top nav (Profile → Sign Out) when logged in.

Profile

Keep your profile current so others can recognize and contact you appropriately.

  1. Navigate to Profile from the top nav or go to /app/profile.
  2. Update your full name, username, and avatar image.
  3. Optionally set location details (e.g., city/state or zip code) to help with nearby features.
  4. Save your changes. Your updates will reflect across the app.

Books

Add a book

  1. Open the My Books section or go to /app/books.
  2. Click Add to search via Google Books by title/author/ISBN. You can also manually edit fields.
  3. Set the book’s condition and availability (mark as available to receive swap requests).
  4. Save to add the book to your library.

Edit or manage a book

  • From your books list or a book’s detail page, click Edit to update details or condition.
  • Toggle availability to control whether others can request a swap for that book.

Discover books

  1. Explore Discover Books at /app/discover.
  2. Browse and filter to find something you like.
  3. Open a book to view details and, if available, request a swap.

Swaps

Request a swap

  1. From a book’s card or detail view, click Request Swap.
  2. Select the book you’re offering (if required) and confirm the request.
  3. The other user will be notified and can respond.

Respond to a swap

  1. Open Swap Requests at /app/swaps.
  2. For incoming requests, choose to Accept or Decline.
  3. If needed, you can Counter with a different offered book.

Counter offers

  • When countering, you’ll select an alternative book you’re willing to trade.
  • The counter offer goes back to the requester for acceptance or further negotiation.

Complete or cancel a swap

  • Complete: Once both parties are satisfied and the exchange is done, mark the swap as completed. This may transfer book ownership in the system.
  • Cancel: If a swap cannot proceed, you or the appropriate party can cancel. The books’ availability will be updated accordingly.

Tip: Use in-app chat (see below) to coordinate timing, shipping, or meeting details with your swap partner.

Communication

Each active swap supports direct messaging between participants.

  1. Open a swap to view the conversation.
  2. Send messages to coordinate logistics or clarify details.
  3. Unread counts and notifications help you keep track of new messages.

Cocktails & Nearby Stores

Generate cocktail ideas

  1. Go to /app/cocktails.
  2. Provide optional preferences or prompts if available, then generate ideas.
  3. Browse the cocktail results and pick a recipe to try.

Find nearby stores

  1. Provide your location (zip code or allow location if supported).
  2. Use the store search to find nearby options for ingredients.
  3. Select a store to view more details.

Notifications

In-product notifications

  • Click the bell icon in the top nav to view notifications.
  • New items may show a badge count (e.g., incoming swap requests).
  • Open an item to view details and mark it as read.

Email notifications

  • Important events (e.g., swap requests) can also trigger emails to the address on your profile.
  • Keep your email up to date in your profile settings.

Tips & Troubleshooting

  • Authentication issues: If you cannot log in, double-check your email and password, or try the Google sign-in if enabled.
  • Permissions: Some actions (like completing/canceling swaps) are limited based on your role in the swap.
  • Images: If an avatar or book image is missing, try re-uploading the image or refreshing the page.
  • Location features: Ensure your zip code or location settings are set for accurate store search results.

Still stuck? See Support.

Support

For help, feedback, or troubleshooting, reach out to sahil.mb@gmail.com. Include relevant details (what you tried, screenshots, error messages) so we can assist quickly.

© Booze & Books — Happy reading and cheers!