Skip to content

About

Nx, made approachable for JavaScript full-stack developers

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

42 Commits

Folders and files

Repository files navigation

nx-archweave

npm: @clearlydev/nx-archweave npm: create-nx-archweave CI License: MIT

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.

What you get

  • Feature-Sliced Design (Lite) lint rule that knows the FSD layers and checks imports between them in your frontend app (warn on solo and quick-start, error on 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 team preset turns it on)

Quick start

# 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.

Why

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:

  1. 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 review check fails on a blocking finding, or when the AI review leaves no verdict it can read.
  2. 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.

Documentation

Contributing

CONTRIBUTING.md covers setup, the end-to-end script, CI and the release process. To report a security issue, follow SECURITY.md.

License

MIT

About

Nx, made approachable for JavaScript full-stack developers

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages