Skip to main content
Develop your AI-powered application locally with the Starter Kit’s built-in development server. All changes to components, pages, and styles reload instantly.

​
Start development server

1

Navigate to your project

cd your-project-name
2

Start the development server

npm run dev
The app runs on http://localhost:3004 by default.
3

Verify it's running

Open your browser to http://localhost:3004 and you should see your application homepage.
Any changes to files in app/, components/, or lib/ will hot-reload automatically.

​
Development features

Turbopack: The Starter Kit uses Next.js 15 with Turbopack for fast refresh and instant updates during development. Server Components: Most components render on the server by default. Client components (marked with "use client") also support hot module replacement. Type checking: TypeScript validates your code in real-time as you edit.

​
Common workflows

​
Adding a new page

  1. Create a new file in app/ following Next.js App Router conventions
  2. Server Components render automatically - no “use client” needed
  3. Save the file and navigate to the route in your browser

​
Modifying components

  1. Edit files in components/ui/, components/generic/, or components/project/
  2. Changes appear instantly in the browser
  3. TypeScript errors show in your editor and terminal

​
Updating configuration

  1. Edit config/app.config.ts for navigation, branding, footer links
  2. Changes to server-side config require restarting the dev server
  3. Client-side config changes hot-reload automatically

​
Troubleshooting

Stop any existing Next.js processes:
# Find process using port 3004
lsof -ti:3004

# Kill the process
kill -9 $(lsof -ti:3004)
Or specify a different port:
PORT=3005 npm run dev
Try these steps:
  1. Save the file explicitly (Cmd+S / Ctrl+S)
  2. Check the terminal for TypeScript errors
  3. Restart the dev server: Ctrl+C then npm run dev
  4. Clear Next.js cache: rm -rf .next && npm run dev
Temporarily disable type checking during development:
# In next.config.ts, add:
typescript: {
  ignoreBuildErrors: true,
},
Re-enable type checking before deploying to production.

​
Next steps

Testing

Run tests locally before deploying

Deployment

Deploy your application to production