constructive-templates

Boilerplate templates for Constructive applications.

Templates

• nextjs/constructive-app — Next.js frontend boilerplate with auth, org management, and GraphQL SDK integration

Quick Local Setup

Local Development

# 1. Start Postgres
docker compose up -d

# 2. Install dependencies
pnpm install

# 3. Setup database
eval "$(pgpm env)"
createdb myapp
pgpm admin-users bootstrap --database myapp --yes
pgpm admin-users add --database myapp --test --yes
pgpm deploy --package myapp-service --database myapp --yes
pgpm deploy --package myapp --database myapp --yes
pgpm deploy --package myapp-test-seed --database myapp --yes

# 4. Codegen
pnpm run codegen

# 5. Start GraphQL server
PGDATABASE=myapp cnc server --port 3000 --origin "*"

# 6. Start the app
cd nextjs/constructive-app && pnpm run dev

Setup

AI agents: The src/graphql/sdk/ directory in nextjs/constructive-app is auto-generated by @constructive-io/graphql-codegen. Never edit it manually — fix the upstream config and re-run pnpm codegen.

In constructive-db repo:

docker-compose up -d
eval "$(pgpm env)"
createdb constructive
pgpm admin-users bootstrap --yes
pgpm admin-users add --test --yes
pgpm deploy --yes --database constructive --package constructive-local

In constructive repo:

pnpm install
PGDATABASE=constructive pnpm dev

In constructive-app package:

pnpm install
eval "$(pgpm env)"
pnpm run create-db
pnpm run provision
pnpm run codegen
pnpm run dev