allthingslinux monorepo

Local monorepo combining the marketing site and the portal (identity stack), imported with tomono so commit history is preserved (same object IDs as the source repos).

Layout

Path	Product
apps/web	Main marketing site (Next.js, OpenNext / Cloudflare)
apps/docs	Product documentation (Mintlify; docs.json at app root)
apps/portal	Portal app (@atl/portal) and workspace packages (apps/portal/packages/*)

Package names: @atl/* is for org-level apps and shared libraries (@atl/web, @atl/portal, @atl/ui, @atl/docs). The portal stack libraries under apps/portal/packages/* use the @portal/* scope (e.g. @portal/db, @portal/api, @portal/typescript-config) so they read as “portal product” rather than org-wide.

Planning context: see monorepo-planning/MASTER.md in your planning repository (canonical layout and ADRs).

Tooling (from repo root)

Task	Command
Install	pnpm install
Build (Turbo graph)	pnpm build
Dev	pnpm dev
Typecheck	pnpm type-check
Tests	pnpm test
Lint + format (Ultracite / Oxlint + Oxfmt)	pnpm check / pnpm fix
Docs preview (Mintlify)	pnpm --filter @atl/docs dev

Checks: Root pnpm check / pnpm fix run Ultracite only (whole repo). The web app also defines pnpm run check (and type-check) under apps/web — that runs contentlayer + tsc + Ultracite for the marketing site. Use pnpm --filter @atl/web check from the root when you mean the web app’s full check.

Note: apps/web is excluded from Oxlint (.eslintignore) until that tree is brought up to the same rules as apps/portal. Oxfmt still formats it. Remove apps/web/** from .eslintignore when you are ready to fix findings.

Shared config (one place)

Concern	Location
Git	Root .gitignore only (nested apps/*/.gitignore removed so rules stay consistent).
Commits	Root commitlint.config.cjs + .husky/commit-msg (pnpm exec commitlint); @commitlint/* is a root devDependency only.
Lint / format	Root .oxlintrc.json + .oxfmtrc.jsonc (Ultracite Oxlint/Oxfmt presets); apps/web lint deferred via .eslintignore.
VS Code / Cursor	Root .vscode/settings.json and .vscode/extensions.json — Oxc (oxlint + oxfmt), Tailwind/i18n-ally recommendations, portal locale paths under apps/portal/.
Cursor ignore	Root .cursorignore only (nested app .cursorignore files removed).
Prettier	Not used for JS/TS; Oxfmt formats. .prettierignore skips apps/docs/** for Mintlify; .eslintignore holds lint exclusions (including generated paths).
Turborepo	Root turbo.json; app overrides in apps/web/turbo.json, apps/docs/turbo.json, apps/portal/turbo.json. Tasks run via turbo run from package scripts; transit is a no-op graph edge for cache invalidation.
CI / GitHub Actions	Workflows and the setup-node-pnpm composite live under .github/workflows/ (e.g. portal-ci.yml, web-deploy.yml). Nested apps/*/.github/workflows are not used by GitHub.
Renovate	Root .github/renovate.json5 — one config for the whole repo (pnpm workspaces, GitHub Actions, Docker, mise).
Docker (portal)	apps/portal/.dockerignore — prune/build context for portal images (not duplicated at repo root).
Mintlify	apps/docs/.mintignore — drafts / paths for the mint CLI (tool-specific; stays next to docs.json).

Open the repository root as the workspace folder so these settings apply.

Requirements

• Node >=24.0.0 (see root package.json engines; .nvmrc and root mise.toml pin 24 for local tooling)
• pnpm >=10 (see packageManager)