Quickstart (Lane A)
Create a local Lane-A product, install peers, and verify Collection access.
Prerequisites
- Node ≥ 20
- Sibling checkouts or vendor path for
@chbrdk/plexon-federationand@chbrdk/dic-app - Test Control Plane URL from
knowledge/paths.md(staging plexon-v3)
Commands (fixture)
From the plexon-v3 repo root:
npm run scaffold:lane-a -- --name demo-portal --skip-plexon
--skip-plexon keeps descriptor writes off the live plexon checkout (demo/throwaway). For a real product, omit the flag and follow knowledge/lane-a-scaffold.md.
Minimal app definition
import { defineDicApp } from '@chbrdk/dic-app'
import { buildFederationHeaders } from '@chbrdk/plexon-federation'
export const app = defineDicApp({
productId: 'demo',
productName: 'Demo',
nav: [{ id: 'home', label: 'Home', href: '/' }],
settingsHref: '/settings',
})
export const headers = buildFederationHeaders({
contractVersion: '2026-05-plexon-federation-v3',
serviceSecret: process.env.PLEXON_SERVICE_SECRET!,
userId: process.env.PLEXON_STAGING_ACTOR!,
})
Verify
npm installin the generated app (registry,file:pin, orvendor/).- Sign in with a test account that has at least one Collection grant.
- Call
GET /api/platform/provisioning/accessible-collectionswith the headers above — expect your Collection id.
Install paths (document which you used):
| Path | When |
|---|---|
GitHub Packages @chbrdk/plexon-federation | Published consumer |
file:../plexon-v3/packages/... | Monorepo sibling |
vendor/ | Scaffolded offline tree |