Architecture

Descriptive notes for today’s seven templates. This is documentation of the product as shipped—not an enforcement contract or upgrade tool.

Shared create flow

You pick a template, a style profile (named or preset), and template options. Yosr Seed renders files, writes .seed/answers.json, and runs that template’s local gate. Profiles are stack-neutral; each template honours or ignores style dimensions as listed below.

Next.js full-stack

Default template (next-fullstack). TypeScript App Router app with notes-style domain examples, agent rules, and optional data, auth, API style, payments, and deploy choices.

  • Options: database none/postgres; ORM Drizzle or Prisma (when postgres); auth none/Auth.js/Clerk; API server actions or tRPC; payments on/off; deploy Vercel or Docker; workflow local/GitHub/none.
  • Gate: install → lint → typecheck → build → test (optional image / db-setup / e2e when selected).
  • Profiles: broad honour of layout, TypeScript, format, lint, tests, forms, and naming. Next-oriented data-fetching semantics apply here.

Hono API

API-only Node.js 24 TypeScript (type stripping, no build step). Hono + Zod OpenAPI, Biome, Vitest.

  • Options: database none / SQLite / Postgres (Drizzle) / MongoDB (official mongodb driver); auth none or API key; deploy none or Docker; workflow local/GitHub/none.
  • Gate: install → lint → typecheck → test (optional image when Docker).
  • Profiles: honours layout, tests location, errors, TypeScript, format, imports. Ignores Next-only lint preset, forms, component naming, and server data-fetching.

FastAPI service

API-only Python 3.12+ with uv, FastAPI, Pydantic v2, Ruff, Pyright, pytest.

  • Options: database none / SQLite / Postgres (SQLAlchemy 2 + Alembic) / MongoDB (PyMongo async); auth none or API key; deploy none or Docker; workflow local/GitHub/none.
  • Gate: sync → lint → format check → typecheck (Pyright) → test (optional image when Docker).
  • Profiles: honours layout, tests location, and error pattern. Ignores TypeScript/format/lint/forms/UI naming dimensions with one create info line.

ASP.NET Core API

API-only ASP.NET Core on .NET 10 (minimal API), xUnit with WebApplicationFactory, locked NuGet restore, and optional EF Core Postgres.

  • Options: database none / Postgres (EF Core + Npgsql; Postgres is the non-interactive default); auth none or API key; deploy none or Docker; workflow local/GitHub/none.
  • Gate: locked restore → format verify → build with warnings as errors → test (optional image when Docker). No EF migrations in the gate.
  • Profiles: honours layout, tests location, and error pattern. Ignores TypeScript/format/lint/forms/UI naming dimensions with one create info line.

Spring Boot API

API-only Spring Boot on Java 25, JUnit 5 with MockMvc, locked Maven resolve, and optional Spring Data JPA Postgres.

  • Options: database none / Postgres (Spring Data JPA; Postgres is the non-interactive default); auth none or API key; deploy none or Docker; workflow local/GitHub/none.
  • Gate: locked Maven resolve → Spotless check → compile → test (optional image when Docker). No Flyway/Liquibase in the gate.
  • Profiles: honours layout, tests location, and error pattern. Ignores TypeScript/format/lint/forms/UI naming dimensions with one create info line.

Web app (Vite + React)

Static SPA: Vite, React, React Router, ESLint, Prettier, Vitest + React Testing Library.

  • Options: API client none or typed fetch (VITE_API_URL); auth none or client API key (VITE_API_KEY, public in the bundle); deploy none / Docker / static; workflow local/GitHub/none.
  • Gate: install → lint → typecheck → test → build (optional image when Docker).
  • Profiles: honours layout, tests, forms, naming, TypeScript, format, lint. Ignores Next server data-fetching.

Website (Astro)

Content-first Astro site with SEO defaults; optional Markdown blog, React islands, and contact form POST.

  • Options: content none/blog; React islands off/on; contact none/API POST; deploy static or Docker; workflow local/GitHub/none.
  • Gate: install → lint → typecheck → build → validate (html-validate + linkinator); optional image when Docker.
  • Profiles: honours layout and file/component naming (pages routes are never renamed). Ignores unit-test placement and Next data-fetching / forms dimensions.