Nx Workspace Patterns
FreeStreamline Nx monorepo management with best practices.
Free · Opens the source repo
What Nx Workspace Patterns does
Nx Workspace Patterns provides a structured approach to managing Nx monorepos, which are increasingly popular for organizing multiple applications and libraries within a single repository. This skill is particularly useful for developers and teams who are either setting up new Nx workspaces or optimizing existing ones. By following the outlined patterns and best practices, users can ensure their projects are well-organized, maintainable, and efficient.
The skill covers essential concepts such as the architecture of an Nx workspace, which includes directories for applications, shared libraries, and custom tools. It emphasizes the importance of defining clear project boundaries and managing dependencies effectively. By implementing the recommended practices, such as enabling caching early and documenting boundaries, teams can significantly improve their continuous integration (CI) processes and overall development workflow.
Additionally, the skill provides templates and worked examples found in the references/details.md file, which serve as practical guides for users looking to implement specific configurations or patterns in their projects. This resource is invaluable for both new and experienced developers who want to adhere to best practices in Nx monorepo management.
Overall, Nx Workspace Patterns is designed for developers who want to leverage the full potential of Nx while avoiding common pitfalls associated with monorepo structures. It offers concrete solutions to streamline workflow and enhance productivity across teams.
When to use it
Use this skill when setting up new Nx workspaces, configuring project boundaries, or optimizing build processes.
When not to use it
This skill may not be suitable for projects that do not use Nx or for teams looking for generic monorepo management solutions.
What you can build with it
Setting Up a New Nx Workspace
Utilize this skill to effectively configure a new Nx workspace, ensuring proper project boundaries and structure from the start.
Optimizing CI Processes
Implement best practices for CI optimization using Nx, such as enabling caching and utilizing affected commands to improve build efficiency.
Managing Dependencies in a Monorepo
Use the guidance provided to manage interdependencies between projects within an Nx monorepo, helping to maintain a clean architecture.
How to install Nx Workspace Patterns
View source1. Install with the skills CLI
npx skills add wshobson/agents/nx-workspace-patterns --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by wshobsonNx Workspace Patterns
Production patterns for Nx monorepo management.
When to Use This Skill
- Setting up new Nx workspaces
- Configuring project boundaries
- Optimizing CI with affected commands
- Implementing remote caching
- Managing dependencies between projects
- Migrating to Nx
Core Concepts
1. Nx Architecture
workspace/
├── apps/ # Deployable applications
│ ├── web/
│ └── api/
├── libs/ # Shared libraries
│ ├── shared/
│ │ ├── ui/
│ │ └── utils/
│ └── feature/
│ ├── auth/
│ └── dashboard/
├── tools/ # Custom executors/generators
├── nx.json # Nx configuration
└── workspace.json # Project configuration
2. Library Types
| Type | Purpose | Example |
|---|---|---|
| feature | Smart components, business logic | feature-auth |
| ui | Presentational components | ui-buttons |
| data-access | API calls, state management | data-access-users |
| util | Pure functions, helpers | util-formatting |
| shell | App bootstrapping | shell-web |
Templates and detailed worked examples
Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.
Best Practices
Do's
- Use tags consistently - Enforce with module boundaries
- Enable caching early - Significant CI savings
- Keep libs focused - Single responsibility
- Use generators - Ensure consistency
- Document boundaries - Help new developers
Don'ts
- Don't create circular deps - Graph should be acyclic
- Don't skip affected - Test only what changed
- Don't ignore boundaries - Tech debt accumulates
- Don't over-granularize - Balance lib count
Frequently asked questions about Nx Workspace Patterns
Similar skills
Turborepo
Optimized build system for JavaScript/TypeScript monorepos.
Azure Pipelines Validation
Streamline your Azure DevOps pipeline changes locally.
Azure Developer CLI
Streamline your Azure project workflows with best practices.
Azure Container Registry CLI
Manage Azure Container Registry resources with ease.
Aspire
Build and orchestrate polyglot distributed applications seamlessly.
Vercel CLI
Manage and deploy Vercel projects from the command line.