THE OPEN WORKSPACE / FIELD NOTES

Run the portfolio

Install dependencies and preview the portfolio locally.

Prerequisites

Install Pixi 0.84.1. Pixi locks Node.js, Bun, and native quality tools; Bun locks the JavaScript workspaces. The devcontainer uses Linux x86-64, while the Pixi lock also includes Linux ARM and macOS platforms.

Prefer a container? Follow Development container.

Install and run

pixi install --locked
pixi run bun install --frozen-lockfile
pixi run bun run --cwd apps/portfolio dev

Open http://localhost:3000/. The development server binds to 0.0.0.0. Documentation search needs the production Pagefind index; the homepage project filter also works in development.

Build

pixi run bun run --cwd apps/portfolio build
pixi run bun run --cwd apps/portfolio test:seo

The build exports HTML, creates AI-readable files, and builds Pagefind search. Serve apps/portfolio/out/ from the root of a static server. A Next.js runtime server is not required or supported with output: 'export'. See the deployment guide and command reference.