Adding an App

How to add a new Next.js app to the monorepo.

1. Copy an existing app

cp -r apps/energy apps/my-app

2. Update package.json

Change the package name and port:

{
  "name": "@numa/my-app",
  "scripts": {
    "dev": "next dev --turbopack -p 300X",
    "start": "next start -p 300X"
  }
}

3. Update proxy.ts

Adjust the routing rules for your new platform’s needs.

4. Add root scripts

In the root package.json, add convenience scripts:

{
  "scripts": {
    "dev:my-app": "turbo run dev --filter=@numa/my-app",
    "build:my-app": "turbo run build --filter=@numa/my-app"
  }
}

5. Add environment variable

Add the cross-app URL to .env.example:

NEXT_PUBLIC_MY_APP_URL=http://localhost:300X

And update @numa/config to export the new URL if needed.

6. Install and verify

pnpm install
pnpm turbo run dev --filter=@numa/my-app

App structure checklist

Your new app should have:

Port assignments