Newbie_CRM/SETUP.md

CRM Frontend - Quick Start

Prerequisites

• Node.js >= 18.17 (recommended: 20.9+ or 22.x)
• npm 9+

Install & Run

cd frontend

# Install dependencies
npm install
npm install devenv
npm install build

# Start dev server
npm run dev

The app runs at http://localhost:3000

Pages

Route	Description
/login	Login page
client-portal/login	Client Login page
/	Dashboard
/leads	Lead management table
/leads/:id	Lead detail view
/users	User management
/settings	Settings (Company, Theme, Notifications)

Tech Stack

• Next.js 15 + React 18
• TypeScript + Tailwind CSS v4
• shadcn/ui components (Radix primitives)
• TanStack Table v8
• Recharts
• Framer Motion
• Lucide Icons

If Node.js is < 20.9

The eslint-config-next package requires Node.js >= 20.9. If your Node.js is older:

npm install --legacy-peer-deps

Or upgrade Node.js via nvm:

nvm install 22
nvm use 22