Constructive Server Configuration

How to run and configure the Constructive GraphQL API server, explorer, and codegen tools. The server exposes a multi-target GraphQL API with subdomain-based routing.

When to Apply

Use this skill when:

• Starting the Constructive GraphQL server (cnc server)
• Opening the GraphiQL explorer (cnc explorer)
• Running code generation (cnc codegen)
• Configuring API routing (header-based vs domain-based)
• Running the server in CI for integration tests
• Understanding the schema → PostGraphile → GraphQL pipeline

Prerequisites

• PostgreSQL 17+ running with a deployed Constructive database (see pgpm skill — references/docker.md and references/env.md)
• @constructive-io/cli installed (npm install -g @constructive-io/cli or available from the monorepo)
• Database users bootstrapped via pgpm admin-users bootstrap --yes