Skip to content

biancacchino/packpal

Repository files navigation

๐ŸŽ’ PackPal.fit

A smart, collaborative packing assistant that makes trip planning effortless.

DevPost

Devpost

๐ŸŒŸ Overview

Built at NewHacks 2025, PackPal.fit is a full-stack web application that helps users organize, save, and manage packing lists for any type of trip. Whether you're planning an international vacation or a weekend getaway, PackPal ensures you never forget essentials or duplicate items across your group.

โœจ Key Features

  • Smart Trip Management: Create, edit, and delete trips with an intuitive dashboard
  • AI-Powered Suggestions: Integrated Gemini 2.5 chatbot provides intelligent packing recommendations based on natural language prompts
  • List Sharing: Collaborate with travel companions and share packing lists
  • Clean, Modern UI: Responsive design with smooth navigation and user-friendly interface

๐Ÿ“ธ Screenshots

PackPal-landing-page PackPal-dashboard PackPal-YourTrips PackPal-Friends PackPal ChatBot using Gemini 2.5 PackPal Trip List w/ChatBot Picture in Picture

๐ŸŽฏ The Problem We Solved

Trip packing often leads to:

  • Overpacking unnecessary items
  • Forgetting essential items
  • Duplicate items when traveling with groups
  • Lack of coordination among travelers

๐Ÿ› ๏ธ Tech Stack

Frontend:

  • Next.js
  • React
  • TypeScript
  • Tailwind CSS

Backend:

  • PostgreSQL
  • Drizzle ORM
  • NextAuth (Authentication)

AI Integration:

  • Google Gemini 2.5 API

Deployment:

  • GoDaddy (Custom Domain)

๐Ÿš€ Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • PostgreSQL database
  • Google Gemini API key

Installation

# Clone the repository
git clone https://github.com/yourusername/packpal.git
cd packpal

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Add your database URL, NextAuth secret, and Gemini API key

# Run database migrations
npm run db:push

# Start the development server
npm run dev

Visit http://localhost:3000 to see the application.

๐Ÿ’ก How It Works

  1. Create a Trip: Set up a new trip with basic details
  2. Get AI Suggestions: Use the chatbot by typing prompts like "I'm going on a 3-day ski trip"
  3. Manage Your List: Add, remove, or edit items as needed
  4. Share with Others: Collaborate with travel companions to avoid overlap
  5. Track Progress: View all your trips from the dashboard

๐Ÿ† Achievements

  • Built a complete full-stack application in under 24 hours
  • Integrated cutting-edge AI technology for practical use
  • Deployed to production with custom domain
  • Created polished, production-ready UI/UX

๐ŸŽ“ What We Learned

  • Industry-standard version control practices with GitHub
  • Team collaboration through branches and merges
  • AI API integration and connecting ML models to web applications
  • Rapid prototyping and development under time constraints
  • Full-stack development workflow from concept to deployment

๐Ÿ‘ฅ My Teammates

About

๐ŸŽ’Smart packing assistant with AI-powered suggestions. Built in 24hrs.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages