Open-source calculators, generators, and planners for better drinks and calmer hosting.
Live site · Tools · Architecture · Testing · Contribute · iPhone app · Garçon
Garçon open tools is the public source for 17 utilities originally built for Fix Me a Drink. The collection covers cocktail discovery, bar calculations, food quantities, and event planning.
Each tool keeps its interface, calculation logic, tests, and safety boundaries together. Most calculations run entirely in the browser. Narrow server routes connect recipe search to the hosted Garçon API without exposing credentials.
The full collection runs at oss.fixmeadrinkapp.com. Individual tool pages retain the same paths as the originals, which makes comparison and contribution straightforward.
Open the live collection and choose a tool. An account is never required.
Use Node.js 22 and npm 10 or newer for local development.
git clone https://github.com/garcon-drinks/garcon-tools.git
cd garcon-tools
npm ci
npm run devOpen http://localhost:3000.
| Tool | Job |
|---|---|
| Cocktail menu template | Build a printable menu from your home-bar inventory. |
| Cocktail by ingredients | Find recipes that match ingredients already on hand. |
| Cocktail name generator | Create names from flavor, occasion, mood, and style. |
| Cocktail glassware finder | Match drink format, volume, temperature, and owned glasses. |
| Bartender cheat sheet | Build a printable recipe and technique practice sheet. |
| Tool | Job |
|---|---|
| BAC calculator | Estimate blood alcohol content from drinks and timing. |
| Cocktail ABV calculator | Calculate strength with dilution included. |
| Batch cocktail calculator | Scale a cocktail, apply dilution, and plan containers. |
| Recipe scaler | Scale ingredient quantities and convert display units. |
| Brix syrup calculator | Convert syrup concentration, density, sugar, and water. |
| Liquor bottle yield calculator | Calculate pours, servings, and bottle requirements. |
| Tool | Job |
|---|---|
| Party drink calculator | Estimate beer, wine, spirits, mixers, ice, and water. |
| Pizza party calculator | Turn a guest list into pizzas, slices, and flavor counts. |
| Charcuterie board calculator | Create a package-rounded shopping list. |
| Taco bar calculator | Plan tortillas, proteins, toppings, sides, and shopping. |
| Drink ticket maker | Create numbered printable tickets for drink service. |
| Catering food calculator | Estimate menu quantities, packages, and dietary coverage. |
The project uses Next.js App Router, React, TypeScript, Tailwind CSS, and
OpenNext for Cloudflare. Pure calculation modules live under lib/free-tools,
with tests alongside the logic they protect.
Fifteen tools perform their primary work in the browser. Recipe-dependent features use same-origin API adapters with explicit empty-state behavior when the upstream service is unavailable.
Search ownership stays with Fix Me a Drink. Tool routes declare
noindex, follow and point their canonical URL to the corresponding production
page. The unique open-source landing page remains indexable and routes readers
to Garçon resources.
Read the architecture guide for route boundaries, failure behavior, analytics rules, and deployment details.
Use the open tools for quick calculations, then continue with Garçon for recipes, collections, and practical bartending guidance.
| Need | Garçon resource |
|---|---|
| Explore the complete drink library | Cocktail recipes |
| Choose recipes by spirit or ingredient | Cocktail collections |
| Find drinks from bottles you own | Cocktail by ingredients |
| Plan beverages for a gathering | Party drink calculator |
| Check a finished drink's strength | Cocktail ABV calculator |
| Learn syrup ratios | Simple syrup guide |
| Compare orange-liqueur swaps | Triple sec substitutes and ratios |
| Understand vermouth | Vermouth guide |
| Start with an approachable drink list | Easy cocktails to make at home |
The repository contains 307 automated tests covering formula behavior, boundary values, invalid input, formatting, and deterministic generators. Health-related calculations carry explicit educational limits and dedicated safety documentation.
Run the complete verification suite locally.
npm run typecheck
npm run lint
npm test
npm run buildThe testing guide explains the test layers and review bar.
Start with CONTRIBUTING.md. Formula changes need focused tests, visible assumptions, and authoritative sources when safety or regulated guidance is involved.
Use GitHub issues for proposals and defects. Security reports belong in a private security advisory.
The software code uses the MIT License.
Garçon and Fix Me a Drink product artwork remain protected brand assets. The banner can stay with forks of this repository but cannot represent an unrelated product. Review TRADEMARKS.md before publishing a fork.