Frontend monorepo for Frontier. Managed with pnpm workspaces and Turborepo.

• Node.js >= 22
• pnpm >= 10.19.0

# from frontier/web
pnpm install

Run everything in parallel:

pnpm dev

Or target a single app with a Turbo filter:

pnpm dev --filter=admin
pnpm dev --filter=client-demo

Or run each package directly from its own directory. Build the SDK first, then start whichever app you're working on:

cd web/sdk
pnpm build

cd web/apps/admin
pnpm dev

cd web/apps/client-demo
pnpm dev

client-demo runs at http://localhost:3000 and proxies API requests to a running Frontier server (see Configure the backend).

Each app talks to a running Frontier instance via a .env file at its own root. These files are git-ignored, so create them before starting a dev server. For a Frontier server running locally with ConnectRPC on :8002:

apps/admin/.env (an apps/admin/.env.example is provided as a template):

FRONTIER_CONNECTRPC_URL=http://localhost:8002/

apps/client-demo/.env:

FRONTIER_CONNECT_ENDPOINT=http://localhost:8002/

The admin app also reads configs.dev.json (served at /configs in dev) for local config and terminology overrides.

The Frontier server embeds the admin dashboard into its binary at build time via //go:embed (see apps/admin/embed.go, which embeds apps/admin/dist). The Go build does not rebuild the frontend, so the binary serves whatever was last built into apps/admin/dist. To embed the latest admin UI, rebuild it before building the server. From the repo root:

make admin-app   # builds apps/admin/dist (the SDK is rebuilt first as a dependency)
make build       # builds the Frontier server binary, embedding the fresh dist

make admin-app runs pnpm build --filter=admin under the hood; because admin depends on the @raystack/frontier SDK, Turbo rebuilds the SDK first, so the embedded app always picks up the current SDK.

Run from frontier/web:

pnpm build      # build all packages
pnpm lint       # lint all packages
pnpm clean      # clean build outputs
pnpm changeset  # create a changeset for releases

The Makefile provides shortcuts, including an admin-only build:

make build        # install deps + build everything
make build-admin  # install deps + build only the admin app

• Frontier documentation
• @raystack/frontier SDK README