An AI-powered travel planning application built with Clean Architecture principles, Next.js 15, TypeScript, and LangGraph.
- ⚡ Next.js 15 with App Router
- 🔷 TypeScript strict mode for type safety
- 🎨 Tailwind CSS + shadcn/ui for modern UI
- 🤖 AI-Powered trip planning with LangGraph agents
- 🔍 RAG Pipeline for intelligent recommendations
- 🗄️ Supabase + Drizzle ORM for database
- 🔐 Authentication with Supabase Auth
- 🧪 Vitest for testing
- 🏗️ Clean Architecture for maintainability
- 🚀 Vercel deployment ready
This project follows Clean Architecture principles with three distinct layers:
┌─────────────────────────────────────────────────────────────┐
│ Frontend Layer (app/, components/) │
│ Next.js pages, React components, UI interactions │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ Backend Layer (lib/) │
│ Services, Database, Auth, Validations, External APIs │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ AI Layer (ai/) │
│ RAG Pipeline, LangGraph Agents, Prompts, Tools │
└─────────────────────────────────────────────────────────────┘
See ARCHITECTURE.md for detailed documentation.
travel-ai/
├── app/ # Frontend Layer - Next.js App Router
│ ├── api/ # API endpoints
│ │ ├── auth/ # Authentication routes
│ │ ├── trips/ # Trip CRUD operations
│ │ ├── health/ # Health check
│ │ └── user/ # User management
│ ├── (auth)/ # Auth pages (login, register)
│ ├── dashboard/ # Protected dashboard pages
│ └── page.tsx # Landing page
│
├── components/ # UI Components
│ ├── ui/ # Reusable primitives (Button, Card, Input, etc.)
│ ├── auth/ # Auth components (LoginForm, ProtectedRoute)
│ ├── dashboard/ # Dashboard widgets (Sidebar, UserProfile)
│ └── trips/ # Trip components (TripCard, TripList)
│
├── lib/ # Backend Layer - Business Logic
│ ├── db/ # Database (Drizzle ORM schema & client)
│ ├── auth/ # Auth helpers (session, middleware)
│ ├── services/ # Business logic (TripService, UserService)
│ ├── validations/ # Zod schemas (trip, user)
│ ├── tools/ # External SDK wrappers
│ │ └── amadeus/ # Amadeus API adapter
│ └── api/ # API client utilities
│
├── ai/ # AI Layer - Intelligent Features
│ ├── rag/ # Retrieval-Augmented Generation
│ ├── agents/ # LangGraph agents
│ │ ├── travel-planner/
│ │ ├── booking-assistant/
│ │ └── recommendation-agent/
│ ├── prompts/ # Prompt templates
│ ├── tools/ # LangChain tools
│ └── config/ # AI model configuration
│
├── types/ # Global TypeScript types
├── store/ # State management (Zustand)
├── tests/ # Test suites
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests
│ └── e2e/ # End-to-end tests
└── public/ # Static assets
- Node.js 20.10+ (Node.js 20 for the Travel AI release checks)
- npm, yarn, or pnpm
- Clone and install dependencies:
pnpm install- Environment setup:
cp .env.example .env.localEdit .env.local and add your environment variables:
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
DATABASE_URL=your_database_url
AMADEUS_API_KEY=your_amadeus_api_key
AMADEUS_API_SECRET=your_amadeus_api_secret- Setup database:
pnpm db:push- Start development server:
pnpm dev- Open your browser: Navigate to http://localhost:3000
- Terminal: Use PowerShell or Windows Terminal. If Corepack is disabled, enable it once with
corepack enable pnpm(run the shell as administrator if permission errors occur). - Database commands: run the scripts in
travel-ai; TLS verification remains enabled. - Execution policy: If PowerShell blocks pnpm scripts, run
Set-ExecutionPolicy RemoteSigned -Scope CurrentUseronce and restart the terminal. - TLS: configure
POSTGRES_CA_CERTfor databases using a private certificate authority.
pnpm dev- Start development serverpnpm build- Build for productionpnpm start- Start production serverpnpm lint- Run ESLint
pnpm db:generate- Generate Drizzle migrationspnpm db:push- Push schema changes to databasepnpm db:studio- Open Drizzle Studio
pnpm test- Run all testspnpm test:unit- Run unit tests onlypnpm test:integration- Run integration testspnpm test:e2e- Run end-to-end testspnpm test:watch- Run tests in watch modepnpm test:coverage- Run tests with coverage report
This project strictly follows clean architecture:
- Separation of Concerns: Each layer has a single responsibility
- Dependency Direction: Dependencies flow downward (Frontend → Backend → AI)
- Type Safety: Full TypeScript with Zod validation at boundaries
- Adapters: External SDKs wrapped in adapters for replaceability
- Testability: Each layer can be tested independently
See ARCHITECTURE.md for complete documentation.
- Push your code to GitHub
- Connect your repository to Vercel
- Deploy automatically on every push
- Build the application:
npm run build- Start the production server:
npm run startSee .env.example for required environment variables.
- Fork the repository
- Create a feature branch
- Make your changes
- Run tests and linting
- Submit a pull request
MIT License - see LICENSE file for details
The workspace HTTP and STDIO servers use SDK 2.3.1 and stateless protocol 2026-07-28. Travel AI uses MCPAdapter 2.0.1 while keeping conversation memory and approvals in application checkpoints. See setup and reproducible verification.