Installation

Get Nexus AI Admin running locally in about 5 minutes.

Prerequisites

• Node.js 20 or newer — check with node --version
• A package manager: npm (ships with Node), pnpm, or yarn
• A code editor (VS Code recommended)

The template was built and tested on Node 20 with npm. Any modern package manager works; commands below use npm.

1. Get the code

If you downloaded a ZIP (Gumroad / Codester), unzip it and open the folder:

cd nexus-ai-admin

If you have the Git repository:

git clone <your-repo-url> nexus-ai-admin
cd nexus-ai-admin

2. Install dependencies

npm install

This installs Next.js, React, Tailwind, shadcn/ui primitives, Recharts, TanStack Table, React Hook Form, Zod and the rest of the stack.

3. Set up environment variables (optional)

The demo runs entirely on mock data, so no environment variables are required to start. To customize the SEO base URL or prepare for a real backend, copy the example file:

cp .env.example .env.local

See Connecting a Database for what each variable is for.

4. Run the dev server

npm run dev

Open http://localhost:3000 — you'll be redirected to /dashboard.

If port 3000 is busy, Next.js automatically uses the next free port (e.g. 3001) and prints the URL in the terminal.

5. Build for production

npm run build   # create an optimized production build
npm run start   # serve the production build locally

Useful scripts

Troubleshooting

• next: command not found — run npm install first.
• Type or lint errors after editing — run npm run typecheck and npm run lint to see exactly what's wrong.
• Node version errors — upgrade to Node 20+. Use nvm to manage versions: nvm install 20 && nvm use 20.

Next: Customization →