Run it locally

Every development server has a fixed port and refuses to start when that port is taken, instead of moving somewhere else.

Prerequisites

  • Node.js 24.18.0, from .nvmrc
  • pnpm@11.15.1, provisioned by Corepack
  • Only for the playgrounds: Bun, Deno, .NET 10.0, Python >=3.13,<3.14

Install

Run these once, from the repository root.

nvm use corepack enable pnpm install

Root commands

  • pnpm devStart the Atlas development server.turbo run dev --filter=@fm/atlas
  • pnpm dev:atlasThe same as pnpm dev, named explicitly.turbo run dev --filter=@fm/atlas
  • pnpm dev:allCheck every prerequisite, then start all development servers. Nothing starts if a check fails.node scripts/dev/prerequisites.mjs && turbo run dev --concurrency=20
  • pnpm checkRun formatting, linting, builds, type checks, and release validation.prettier . --check && eslint . && markdownlint-cli2 && turbo run build && tsc --noEmit && turbo run typecheck && node scripts/release/validate-release.mjs --static && node scripts/versioning/validate-versions.mjs
  • pnpm buildBuild every workspace in dependency order.turbo run build
  • pnpm dev:testTest the port preflight, prerequisite check, and development scripts.node --test scripts/dev/*.test.mjs

Start one workspace with pnpm --filter <workspace> dev.

Development ports
PortWorkspaceLocal addressCommand
3001@fm/playground-bunhttp://127.0.0.1:3001pnpm --filter @fm/playground-bun dev
3002@fm/playground-denohttp://127.0.0.1:3002pnpm --filter @fm/playground-deno dev
3003@fm/playground-pythonhttp://127.0.0.1:3003pnpm --filter @fm/playground-python dev
3004@fm/playground-dotnethttp://127.0.0.1:3004pnpm --filter @fm/playground-dotnet dev
3300@fm/knowledge-hubhttp://127.0.0.1:3300pnpm --filter @fm/knowledge-hub dev
3301@fm/documentation-sitehttp://127.0.0.1:3301pnpm --filter @fm/documentation-site dev
3302@fm/noteshttp://127.0.0.1:3302pnpm --filter @fm/notes dev
3303@fm/bookmarkshttp://127.0.0.1:3303pnpm --filter @fm/bookmarks dev
3304@fm/boardflowhttp://127.0.0.1:3304pnpm --filter @fm/boardflow dev
3305@fm/snippetshttp://127.0.0.1:3305pnpm --filter @fm/snippets dev
3306@fm/habitshttp://127.0.0.1:3306pnpm --filter @fm/habits dev
3307@fm/codegardenhttp://127.0.0.1:3307pnpm --filter @fm/codegarden dev
3308@fm/atlashttp://127.0.0.1:3308pnpm --filter @fm/atlas dev

These addresses exist on your own machine once a server is running, so they are not links. A server refuses to start if its port is taken.