Skip to content
Plyy Docs

Development Workflow

AI dev commands

Section titled “AI dev commands”
Terminal window
pnpm dev:ai     # web backend (:3000) + agent runtime (:4500)
pnpm dev:agent  # agent runtime only (:4500)

Quality gates

Section titled “Quality gates”
Terminal window
pnpm lint      # biome (app + libs; cms/template starter code excluded)
pnpm check     # lint + typecheck + all test suites (bun ×3 + cargo, in parallel)

Builds

Section titled “Builds”
Terminal window
pnpm build     # checks, then a macOS DMG into builds/ (gitignored)
  • With scripts/tauri-signing.env present, the DMG is signed and notarized; otherwise the build is ad-hoc (local/dev).
  • SKIP_CHECKS=1 pnpm build skips the quality gate for a fast rebuild.
  • Archived artifacts are named Plyy-v<version>-<date>-<git-sha>.dmg.
  • The workspace-wide Turbo build is still available as pnpm build:packages.

Formatting

Section titled “Formatting”
Terminal window
pnpm format    # prettier for ts/tsx/md

Documentation site

Section titled “Documentation site”

The docs (this site) live in apps/docs and are built with Astro Starlight.

  • pnpm dev:docs serves them at http://localhost:4400.
  • Pages are Markdown/MDX files under apps/docs/src/content/docs/.
  • The sidebar is configured in apps/docs/astro.config.mjs (the Reference section auto-generates from the reference/ directory).