Stone.js - Starters

This repository contains official starter templates for Stone.js applications.

---

Overview

It is used internally by the Stone CLI to generate scaffolded projects for both microservices and frontend React apps, with three predefined levels of complexity: basic, standard, and full.

Available Starters

Each starter reflects a different level of complexity and domain (microservice or React), with both declarative and imperative styles available. You can pick the one that matches your architecture preferences and scale needs.

Microservice Starters

Name	Description
basic-service-declarative	Minimal Stone.js microservice using class and decorators
basic-service-imperative	Minimal functional microservice with handler and blueprint
standard-service-declarative	Adds routing, DI, and hooks with a clean declarative structure
standard-service-imperative	Functional routing setup with middleware and service container
full-service-declarative	Production-grade setup: lifecycle hooks, DI, error handling, tests
full-service-imperative	Complete functional microservice with config, tests, and events

React App Starters

Name	Description
basic-react-declarative	Minimal React + Stone.js (SPA/SSR-ready) using class-based API
basic-react-imperative	Minimal React app using functional API and manual config
standard-react-declarative	Adds layout, routing, and lifecycle via decorators
standard-react-imperative	Function-based setup with routing, layout system, and render control
full-react-declarative	Enterprise-ready app with head config, hydration, and complete structure
full-react-imperative	Full functional React app with SSR, hooks, tests, and platform config

You can combine complexity level (basic, standard, full), domain (react, service), and style (declarative, imperative) to find the right starter, for example: standard-react-imperative.

How It's Used

These starters are not meant to be installed manually.

Instead, the @stone-js/cli automatically pulls from this repository during:

npm create @stone-js

or

stone init

The CLI fetches the appropriate template based on user choices and sets up a ready-to-run project in seconds.

Starter Structure

Each starter is a self-contained folder containing:

• app/, asset/, public/, tests/ depending on the type
• Minimal stone.config.mjs or framework config
• Preset integration (e.g. adapters, blueprint, lifecycle)
• Preconfigured TypeScript + Vitest (for standard/full)
• Working example of event handler or route

Maintaining the Starters

To update or add a new starter:

1. Fork or clone this repository.
2. Add or modify the corresponding folder (e.g., react-full, micro-basic).
3. Keep external dependencies minimal.
4. Test the template using the CLI locally.
5. Submit a PR following the Contributing Guide.

The Stone CLI will always fetch the latest main branch when scaffolding.

Why Three Levels?

Stone.js follows a progressive complexity approach. These templates help developers grow their app without needing to eject or reconfigure from scratch.

• Basic: Hello world in 10 seconds.
• Standard: Real-world app features with good defaults.
• Full: Production-grade architecture with opinions.

Learn More

This package is part of the Stone.js ecosystem, a modern JavaScript framework built around the Continuum Architecture.

Explore the full documentation: https://stonejs.dev

Contributing

See Contributing Guide