jst — Vite Starter Template

SHA-256: 331958505f86f9cc4c468d01aab7a0cb1bcf9acafda7ff4d893f2e5e5f2821b6

2026-10-03T22:30:37.312Z

<p align="center">
  <img src="docs/assets/banner.svg" alt="JST — architecture-first React starter" width="1200">
</p>

<p align="center">
  <a href="https://github.com/jst-stack/jst/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/jst-stack/jst/ci.yml?branch=main&style=flat-square&label=CI" alt="CI status"></a>
  <img src="https://img.shields.io/badge/Node.js-24_LTS-5FA04E?style=flat-square" alt="Node.js 24 LTS">
  <img src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square" alt="React 19">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-6F9CFF?style=flat-square" alt="MIT license"></a>
</p>

# JST

An architecture-first React starter for products that need server rendering, explicit dependency boundaries, typed data flow, and enforceable quality gates from the first commit.

## Quick start

Create a project with the official initializer:

```bash
npm create jst@latest my-app
cd my-app
npm run dev
```

The initializer configures the project, installs dependencies, and starts from the clean application shell.

JST requires Node.js 24 LTS and supports npm and pnpm. Released CLI, template, and architecture-plugin combinations are recorded in [`jst.compatibility.json`](jst.compatibility.json); project migrations use the same manifest instead of guessing from dependency versions.

## Showcase

The full architecture walkthrough and working API/persistence flows live in the independent [JST Showcase](https://github.com/jst-stack/jst-showcase), pinned here as the `showcase` Git submodule. Generated applications do not include it.

Create the reference application deliberately with `npm create jst@latest my-demo -- --example showcase`.

## Included

- React 19 and React Router framework-mode SSR
- TypeScript, Vite, and filesystem route discovery
- Dependency injection with request-scoped composition and auto-discovered providers
- A documented path for repository, DTO validation, mapper, service, view-model, entry, and props-driven view boundaries
- CSS Modules, Stylelint, SVG sprites, Vitest, Playwright, Axe, ESLint boundaries, React Doctor, Knip, Husky, and lint-staged

## Architecture

```text
app → pages → widgets → features → entities → shared
```

Dependencies point toward stable policy. Pages compose the application, features own user outcomes, entities own domain behavior and I/O contracts, and `shared` contains product-agnostic infrastructure only.

Read [Architecture](docs/architecture.md) before adding a non-trivial vertical slice. Coding agents should follow [the repository architecture skill](skills/frontend-architecture/SKILL.md).

## Commands

| Command | Purpose |
| --- | --- |
| `npm run dev` | Start the SSR development server |
| `npm run build` | Type-check and create production client/server builds |
| `npm run test:unit` | Run unit and integration tests once |
| `npm run test:e2e` | Run browser contracts and accessibility checks |
| `npm run lint` | Check code, styles, and architecture boundaries |
| `npm run doctor` | Diagnose React correctness and maintainability issues |
| `npm run check` | Run the complete local CI gate |
| `npm run create:slice -- entity account` | Create a canonical entity, feature, or widget slice |
| `npm run template:setup` | Configure the new product |

## Project policy

- [Compatibility](docs/compatibility.md)
- [Migrations](docs/migrations.md)
- [Production and deployment](docs/deployment.md)
- [Troubleshooting](docs/troubleshooting.md)
- [Release process](docs/releasing.md)
- [Contributing](CONTRIBUTING.md)
- [Security](SECURITY.md)
- [MIT License](LICENSE)

Maintained by [@antonbelous0v](https://github.com/antonbelous0v).