Source for vortex.dev, the marketing site for Vortex — an extensible, state-of-the-art columnar file format. Vortex is a Linux Foundation incubating project, a Series of LF Projects, LLC.
Prerequisites: Bun ≥ 1.3.13 and Node ≥ 22. Bun is the package manager and script runner; Next.js itself runs on Node.
git clone git@github.com:vortex-data/vortex.dev.git
cd vortex.dev
bun install
bun dev # Turbopack dev server on http://localhost:3000| Command | What it does |
|---|---|
bun dev |
Next.js dev server with Turbopack |
bun run build |
Production build. Also runs velite to populate .velite/ and emits next-env.d.ts |
bun run start |
Production server (run after build) |
bun run check |
Biome lint + format + import-organize, with auto-fix |
bun run check:ci |
Biome no-write check — what CI runs |
bun run typecheck |
tsc --noEmit. Must run after bun run build because velite populates .velite/ and Next emits next-env.d.ts during build |
bun run verify |
HTTP suite against a running server: sitemap, robots, RSS, OG, canonicals, JSON-LD, theme parity, /api/subscribe, internal links |
bun run test:e2e |
Playwright browser smoke (Chromium desktop + WebKit iPhone-13). One-time setup: bun run test:e2e:install |
bun run lighthouse |
Local Lighthouse CI run against bun run start |
CI runs check:ci → build → typecheck → start → verify → audit → playwright on every PR via .github/workflows/ci.yml, plus an independent Lighthouse audit via .github/workflows/lighthouse.yml that posts a sticky score table.
The Developer Certificate of Origin is enforced on every commit. Sign off with:
git commit -sCI rejects PRs whose commits don't have a Signed-off-by: trailer (DCO probot check).
For architectural context — content pipeline, design tokens, audit advisories, deployment quirks — see CLAUDE.md.
For the Vortex file format itself and its tooling, see github.com/vortex-data/vortex.