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

Skip to content

dropecosta/beer-collection-app

Repository files navigation

🍺 Beer Collection App

License Next.js TailwindCSS

A modern, fully responsive web application to explore, sort, and manage a personal beer collection. Featuring light/dark mode support, customizable filters, and a sleek, user-friendly interface.


🚀 Features

  • Browse Beers: View a grid of beers fetched from Punk API.
  • Sort & Filter: Order by name, ABV, IBU, EBC, or year.
  • Custom Beers: Add your own beers and manage them locally.
  • Detail View: View detailed information with image, stats, and food pairings.
  • Dark Mode: Seamless light and dark themes with a toggle.
  • Responsive Design: Optimized for mobile, tablet, and desktop.

🛠️ Tech Stack

  • Framework: Next.js (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS, class-variance-authority (CVA)
  • UI Primitives: Radix UI
  • Icons: Lucide React
  • Testing: Vitest, React Testing Library

📝 Getting Started

Prerequisites

  • Node.js v16+
  • npm or yarn

Installation

  1. Clone the repository:
    git clone https://github.com/your-username/beer-collection-app.git
    cd beer-collection-app
  2. Install dependencies:
    npm install
    # or
    yarn

Running Locally

npm run dev
# or
yarn dev

Open http://localhost:3000 in your browser.


🧪 Scripts

Command Description
npm run dev Start development server
npm run build Build for production
npm start Start production server
npm run lint Run ESLint
npm run test Run unit tests with Vitest

📐 UI / UX

Home Page Home Page - Darkmode Home page with sorting and dark mode

Detail View Beer detail page with stats and actions

Add new beer form Feature to add new beers to catalog


🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details.


📝 License

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


✉️ Contact

Pedro Reis
📧 [email protected]
LinkedIn | GitHub

About

Dynamic Beer Collection App. Built with Next.js15, ShadcnUI, TailwindCSS and Vitest.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published