English | 한국어
Nx, made approachable for JavaScript full-stack developers.
nx-archweave is an Nx plugin plus a create-* CLI. Together they set up the parts of an Nx workspace that most teams end up building by hand.
- Feature-Sliced Design (Lite) lint rule that knows the FSD layers and checks imports between them in your frontend app (
warnon solo and quick-start,erroron team) - Frontend/backend boundaries when you pick a backend: imports between the frontend and backend projects nx-archweave tags become lint errors
- Generators that add FSD slices and segments as you need them
Optional, each one on its own switch:
- AI agent rule files for the AI coding tools you use
- GitHub issue and PR templates
- Automated PR review with the AI provider you choose: Claude is supported, Gemini, GPT and Cursor are in beta. The create CLI leaves it off unless you ask (the
teampreset turns it on)
# New workspace, configured end to end (npm)
npx create-nx-archweave my-app
# The same with pnpm
pnpm dlx create-nx-archweave my-app
# Or add the plugin to an existing workspace (pnpm with a pnpm-workspace.yaml: add -D -w)
npm install -D @clearlydev/nx-archweave
# then commit the install before running init: init needs a clean working tree| Package | What it is |
|---|---|
@clearlydev/nx-archweave |
The Nx plugin, with 16 generators |
create-nx-archweave |
The CLI: one command from nothing to a configured workspace |
Requirements: Node >= 22.18, plus one of npm, pnpm >= 10, yarn (classic or berry) or bun. Use the latest patch release of your Node line: the November 2026 security release is 22.23.5, 24.22.3 or 26.13.1.
Note
The tools always print their reports in English. The --locale option sets the language of generated content (agent rules, templates, review prompts). It doesn't change the CLI output.
Nx is powerful. Still, when you start a new full-stack JS project, you have to make a long list of decisions before you write a line of product code:
- how to lay out folders
- how to stop layers from importing each other backwards
- what to put in
CLAUDE.md - which GitHub templates to add
- whether to wire up AI code review at all
nx-archweave answers those five questions with opinionated, preset-driven generators. You can still run, preview and skip each piece on its own. Two invariants shape the whole design:
- AI review is optional, end to end. If you turn review off, the generated workspace contains zero review artifacts, and the library still works fully without any AI provider. If you turn review on, the generated workflow ends green with a notice until you register the provider secret. After that, the
reviewcheck fails on a blocking finding, or when the AI review leaves no verdict it can read. - Generators never surprise you. Every generator shows you what it would do before it writes anything. The workspace generators preview with
--dryRun. The two integration generators act outside your workspace, so they only preview until you pass--apply. Running a generator twice changes nothing. If a precondition isn't met, the generator tells you why instead of throwing.
- Getting started — installing, the create CLI's questions and flags, adding the plugin to an existing workspace
- Generators and presets — all 16 generators and what each preset turns on
- Automated PR review — setting it up, providers, when the check is green or red, troubleshooting
- FSD Lite — the layer rules, the
archweave/fsd-boundariesESLint rule, Steiger - Enforced boundaries — frontend/backend/shared scope rules for full-stack workspaces
- Optional plugins — the per-host plugin catalog, installing and verifying a plugin
- Behavioral contracts — what every generator promises: previews, idempotence, refusals
- Repository layout — how the packages fit together
CONTRIBUTING.md covers setup, the end-to-end script, CI and the release process. To report a security issue, follow SECURITY.md.