starwards-monorepo

Coordinate npm workspace monorepo builds with core-first build order.

42|2|Updated Mar 17, 2019
One-click install
npx skills add https://github.com/starwards/starwards --skill starwards-monorepo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: starwards-monorepo
Source: https://github.com/starwards/starwards/tree/main/.claude/skills/starwards-monorepo
Command: npx skills add https://github.com/starwards/starwards --skill starwards-monorepo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires npm.

What problem does it solve?

Monorepos can be complex, leading to build errors, dependency issues, and inefficient development workflows. This skill provides a clear guide to the Starwards npm workspace monorepo, ensuring correct build order, dependency management, and efficient development.

Core Features & Use Cases

  • Build Order Enforcement: Ensures core module builds first, preventing common dependency-related errors.
  • 3-Terminal Development Workflow: Guides setting up watch modes and dev servers for seamless, hot-reloading development.
  • Use Case: If you encounter a "module not found" error after changing a core file, this skill will guide you to ensure core is rebuilt and dependent modules are correctly linked.

Quick Start

"I'm setting up my Starwards development environment. How do I get all modules running correctly?"

Frequently Asked Questions about starwards-monorepo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up and build an npm workspace monorepo correctly?

An npm workspace monorepo coordinates multiple packages with enforced build order. Start by ensuring your core module builds first, then dependent modules follow in sequence. Use `npm run build` to trigger the full orchestrated build across all modules, producing consistent artifacts in cjs/ and dist/ directories.

Why am I getting module not found errors after changing core files?

Build order matters in monorepos. When you modify the core module, dependent modules won't see the changes until core rebuilds and its artifacts are linked. Always rebuild core first, then rebuild dependent modules in the correct sequence to resolve missing module errors.

How do I set up watch mode for efficient development across multiple modules?

Use a 3-terminal development workflow: run watch mode in core, start dev servers in dependent modules, and execute integration tasks in a third terminal. This enables hot-reloading and immediate feedback across the monorepo without manual rebuilds.

Can I build individual modules without rebuilding the entire monorepo?

Yes, selective module builds are supported through npm workspace scripts like `build:core` and targeted module commands. Run selective builds when you've only modified specific modules, but ensure core rebuilds first if its dependencies changed.

How do I run tests and CI/CD pipelines in an npm workspace monorepo?

Integrate testing workflows through monorepo orchestration scripts that run unit and E2E tests across environments (browser, node-red, server, e2e). CI/CD pipelines coordinate the same build order and testing sequence as local development for consistency.

What's the correct build order for the Starwards modules?

Core must build first, followed by server, browser, node-red, and e2e modules in dependency order. This enforced sequence prevents missing dependencies and ensures parallel builds can execute safely without conflicts or rebuild failures.