Installation

This guide walks you through setting up the AI Feedback Assistant demo application.

System Requirements

• Node.js 18.17 or later
• npm 9+, pnpm, or yarn
• Git for cloning the repository

Step 1 — Clone the Repository

git clone <your-repo-url> ai-feedback-assistant
cd ai-feedback-assistant

Step 2 — Install Dependencies

npm install

This installs Next.js 16, React 19, Tailwind CSS 4, Radix UI, and all component dependencies.

Key Dependencies

Package	Purpose
next 16.x	React framework (latest)
react 19.x	UI library
tailwindcss 4.x	CSS framework
@radix-ui/*	Accessible UI primitives
@tanstack/react-table	Data tables
react-hook-form + zod	Form handling
lucide-react + @heroicons/react	Icons
next-themes	Theme switching
sonner	Toast notifications
cmdk	Command palette
input-otp	OTP input

Step 3 — Start the Dev Server

npm run dev

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

Step 4 — Explore the Demo

Navigate through the application routes:

• /authentication/login — login page with social providers
• /authentication/signup — registration form
• /onboarding — first-time user setup
• /home — main application dashboard
• /notifications — notification center
• /composites — component explorer
• /recipes — recipe pattern demos

Available Scripts

Command	Description
npm run dev	Start dev server with Turbopack
npm run build	Create production build
npm run start	Run production server
npm run lint	Run ESLint checks

No Environment Variables Needed

The demo runs entirely on the client side. No API keys or environment configuration is required for browsing components and pages.

To connect a real backend, add API endpoints in the auth form handlers and create a .env.local file with your provider credentials.

Troubleshooting

Port 3000 already in use:

npm run dev -- -p 3001

Build errors after cloning:

rm -rf node_modules .next
npm install
npm run dev