propel

A Turborepo + pnpm monorepo.

Docs

• docs/design.md — the shared design + code contract: how we name component properties and structure component anatomy.
• docs/integration.md — how we adopt propel into Plane: the explicit-first rollout, composing primitives with Base UI render, and the remaining anatomy work.
• packages/propel/README.md — the @makeplane/propel package: install, usage, and component conventions.

Prerequisites

• Node — the version in .node-version.
• pnpm — the version is pinned by packageManager in package.json; enable it with corepack enable.

Workspace layout

propel/
├── apps/       # applications (e.g. docs, the Astro docs site)
├── packages/   # shared libraries (e.g. @makeplane/propel)
└── tools/      # internal tooling (e.g. the Oxlint plugin)

Common commands

pnpm install          # install dependencies
pnpm dev              # run dev servers                 (turbo run dev)
pnpm build            # build all packages              (turbo run build)
pnpm test             # run tests                       (turbo run test)
pnpm check            # check:format + check:lint + check:types
pnpm check:lint       # lint with Oxlint
pnpm check:format     # verify formatting with Oxfmt
pnpm check:types      # type-check
pnpm fix              # auto-fix: fix:format + fix:lint

Tasks are orchestrated by Turborepo (turbo.json). The underlying tools are tsdown (library builds), Vitest (tests), and Oxlint / Oxfmt (lint / format). Run a single package's task with pnpm exec turbo run <task> --filter=<package>.