KnearMe Portfolio Local Development

Prerequisites

• Node.js 22.21.1 (from engines.node).
• pnpm workspace install completed at repo root.
• Supabase project credentials for local .env.local.

Setup

cd /Users/aaronbaker/knearme-platform
pnpm install

Create apps/knearme-portfolio/.env.local with required values (see environment doc).

Start the app

pnpm -C apps/knearme-portfolio dev

Default local URL: http://localhost:3000.

Common developer loops

1. Type and lint before committing:

pnpm -C apps/knearme-portfolio typecheck
pnpm -C apps/knearme-portfolio lint

2. Run focused unit tests:

pnpm -C apps/knearme-portfolio test:unit

3. Run mocked E2E suite:

pnpm -C apps/knearme-portfolio test:e2e:mock

Local dependencies and coupling

• The app builds an MCP widget bundle during build using build:widget.
• Local dev typically does not require apps/knearme-edge, but production path protections rely on edge routes.
• If testing worker-protected behavior, run edge worker separately.