APV Calculator - Alcohol By Volume Calculator

A modern, mobile-first web application for calculating Alcohol By Volume (ABV) percentages for homebrewing and craft beverage production. Features an AI-powered name generator for your creations. View the preview of the app.

🍺 Features

• ABV Calculator: Calculate alcohol content using Original Gravity (OG) and Final Gravity (FG)
• AI Name Generator: Generate creative names for your beverages using Google's Gemini AI
• Real-time Calculations: Instant ABV percentage updates as you input values
• Multiple Beverage Types: Support for beer, wine, cider, mead, and other beverages

🛠 Tech Stack

• Framework: Next.js
• Language: TypeScript
• Styling: Tailwind CSS
• AI Integration: Google Gemini AI API
• Deployment: Vercel-ready
• Package Manager: npm

🚀 Getting Started

Prerequisites

• Node.js 18+
• npm or yarn
• Google Gemini API key

Installation

1. Clone the repository

   git clone <repository-url>
   cd apv-brewing

2. Install dependencies

   npm install

3. Set up environment variables Create a .env.local file in the root directory:

   NEXT_PUBLIC_BASE_URL=http://localhost:3000
   GEMINI_API_KEY=your_gemini_api_key_here

4. Get a Gemini API Key

   • Visit Google AI Studio
   • Sign in with your Google account
   • Create a new API key
   • Copy the key to your .env.local file

5. Run the development server

   npm run dev

6. Open your browser Navigate to http://localhost:3000

📖 How to Use

🔧 Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Run ESLint

🌐 Deployment

Vercel (Recommended)

1. Push your code to GitHub
2. Connect your repository to Vercel
3. Add environment variables in Vercel dashboard
4. Deploy automatically

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Happy Brewing! 🍻