Building a React starter with enforceable architecture

说明与用途

JST 模板通过定义架构层和 ESLint 规则，帮助 React 项目保持清晰结构。

问题

Developers struggle to maintain clean architecture and enforce boundaries in growing React applications.

结果

The JST template enforces architectural boundaries, reduces code coupling, and provides mechanical checks that help developers maintain a clean structure as projects grow.

工作流

• 1. Define architectural layers: Pages, Features, Entities, External effects, Concrete implementations.
• 2. Create a template with conventional tooling (React, TypeScript, SSR, routing, tests).
• 3. Add ESLint rules and repository checks to enforce boundary violations.
• 4. Separate architecture rules from general code‑quality rules into plugins.
• 5. Provide generators for entities, features, widgets, modules, and packages to establish boundaries at creation.
• 6. Run diagnostics in editor, pre‑commit, and CI to reject violations and explain expected routes.
• 7. Offer a project‑local MCP server for coding agents to receive architecture context and bounded checks.

证据

I started converting the rules that could be checked mechanically into ESLint rules and repository checks. They now run in the editor, before a commit, and in CI.

来源

JST includes generators for entities, features, widgets, modules, and packages. Their purpose is not to save a few keystrokes. They create the smallest valid public API and dependency shape so that a developer starts from a known state.

来源

The first evaluation was not flattering to JST. Under the original time limit, the control setup completed five of five retained runs, while JST completed one of five retained runs.

来源