Thanks to visit codestin.com
Credit goes to github.com

Skip to content

yashnaiduu/Alchemy

Repository files navigation

Alchemy Logo

🧪 Alchemy

The Magic of Mixing

✨ Experience the Live App · Getting Started

Angular PrimeNG TypeScript Tailwind


🍸 About The Project

Alchemy is a premium cocktail discovery application designed for the modern mixologist. It bridges the gap between your home inventory and professional bartending.

Unlike standard recipe apps, Alchemy focuses on "What can I make right now?" by intelligently matching your available ingredients against a curated database of 100+ classic and modern cocktails.

Wrapped in a stunning glassmorphism UI, it offers a visually immersive experience that feels as premium as the drinks you create.

✨ Key Features

  • 🔍 Smart Discovery - Instantly browse 109+ curated, verified recipes.
  • 🎒 Pantry Matcher - Input your home inventory to find compatible cocktails.
  • 🎨 Glassmorphism UI - distinct, beautiful aesthetic with backdrop blurs and smooth gradients.
  • 📱 Fully Responsive - Optimized experience across desktop, tablet, and mobile.
  • 🌙 Dark Mode - Easier on the eyes for those late-night mixing sessions.
  • 💾 Favorites System - Save your go-to drinks for quick access.

🛠️ Tech Stack

This project is built with a focus on modern, type-safe web development standards:

Layer Technology
Framework Angular 19 (Latest)
UI Library PrimeNG
Styling Tailwind CSS & Vanilla CSS
Language TypeScript
Deployment GitHub Pages (Automated Workflow)

🚀 Getting Started

Follow these steps to set up the project locally.

Prerequisites

  • npm
    npm install npm@latest -g
  • Angular CLI
    npm install -g @angular/cli

Installation

  1. Clone the storage
    git clone https://github.com/yashnaiduu/Alchemy.git
  2. Navigate to project
    cd Alchemy
  3. Install dependencies
    npm install
  4. Start the server
    npm start
    Your app will be live at http://localhost:4200

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📧 Contact

Yash Naidu - GitHub

Project Link: https://github.com/yashnaiduu/Alchemy


Transforming ingredients into experiences. 🥃✨

About

Alchemy: The Magic of Mixing.

Topics

Resources

Stars

Watchers

Forks

Contributors