FAQ & Troubleshooting

General

What is Nexus AI Admin? A production-grade Next.js 16 admin dashboard template for AI SaaS products — 20 pages, 70+ components, dark/light mode, TypeScript throughout, with realistic mock data.

Is this a full SaaS / does it include a backend? No. It's a frontend template. Authentication, billing, AI calls and email are UI only (mocked). See Connecting a Database to add a real backend.

What stack does it use? Next.js 16 (App Router), TypeScript, Tailwind CSS v4, shadcn/ui, Recharts, TanStack Table, React Hook Form + Zod, next-themes.

Does it support dark mode? Yes — dark and light, with a toggle and a ⌘K command palette to switch. There's also an accent color picker with seven themes (see Customization).

Does it support multiple languages? Yes. Five languages ship in (English, Spanish, French, German, Arabic) with a navbar language switcher, and Arabic enables full right-to-left layout. See Internationalization.

Is it responsive? Yes, from 320px phones up to large desktops. The sidebar becomes a drawer on mobile.

Licensing

Which license do I need? One commercial license per purchaser — see LICENSE.txt. It lets you build and ship unlimited products, including commercial ones and products sold to end users. You may not resell or redistribute the template itself.

Can I use it for client work? Yes. As the license holder you can use the template to build products for clients. You just can't hand over or resell the raw template as a template. Questions: hello@cosmoclan.in.

Troubleshooting

npm install fails. Ensure Node 20+ (node --version). Delete node_modules and package-lock.json, then reinstall.

next: command not found. Dependencies aren't installed — run npm install.

Port 3000 already in use. Next.js automatically falls back to the next free port and prints the URL. Or free 3000 / set PORT.

A lucide icon import errors (e.g. Github). Brand icons were removed from lucide-react v1.x. Use a generic icon or an inline SVG (the social sign-in buttons already use inline SVGs).

Charts log a width/height warning. The included wrappers gate rendering on mount to avoid this. If you add a raw Recharts ResponsiveContainer, wrap it the same way (see src/components/charts/chart-primitives.tsx).

Type or lint errors after editing. Run npm run typecheck and npm run lint to see precise locations.

Support & updates

• Support: hello@cosmoclan.in
• Changelog: ../CHANGELOG.md
• Include your purchase/order reference when contacting support.

Back to the documentation index.