Release Notes
This page sums up how Strutvane’s versions work, shows the support table, and lists what is new, deprecated and retired in 0.2, with the replacement for everything retired. A version line is a family of releases that never break each other: 0.2.0, 0.2.1 and 0.2.2 are the 0.2 line. The full policy is on Versioning & Support.
Versioning in one minute
Section titled “Versioning in one minute”- Within a line, nothing breaks. 0.2.0, 0.2.1 and 0.2.2 are the 0.2 line;
npm updatekeeps you inside it safely. - A new line may break. Before 1.0 each
0.Nline plays the role of a major; every breaking change is in the upgrade guide. - The core packages share one number. Framework, auth, ui, the designs and the installer release together; add-ons have their own versions.
- Each line has a branch, an npm dist-tag and its own docs.
latestis the current line.
The full rules (support windows, branches, dist-tags, where fixes go, how deprecations and retirements work) are on Versioning & Support.
| Version | Node | Release | Bug fixes until | Security fixes until | Status |
|---|---|---|---|---|---|
| 0.2you are reading these docs | 24.3+ | Not released yet | Release of the next line | Next line’s release + 6 months | Bug and security fixes |
| 0.1 | 24+ | Pre-releases only | — | — | End of life |
Legend:Bug and security fixesSecurity fixes onlyEnd of life
This table is generated from the project’s one support table (versions.json) every time the docs are built, so it is the same, and current, in every version of these docs.
What’s new in Strutvane 0.2
Section titled “What’s new in Strutvane 0.2”Strutvane 0.2 rebuilds the framework around Laravel’s flow. If you used 0.1, read the upgrade guide first.
New in 0.2
Section titled “New in 0.2”The packages that make up 0.2 (all in development): @strutvane/framework, @strutvane/auth, @strutvane/ui, create-strutvane, strutvane, @strutvane/log-viewer, and the designs @strutvane/design-crisp (default) and @strutvane/design-vivid.
One command to start. npm create strutvane@latest my-app asks what you need (a few quick questions in Recommended mode, or every option in Custom mode), then installs, sets up the database (MySQL by default), migrates, seeds and makes a first commit. See Installation.
Migrations are the source of truth. Columns are written in migrations with a Laravel-style Schema builder, and your TypeScript types are generated from them:
schema.create('posts', (t) => { t.id() t.string('title', 200) t.slug('slug').from('title') t.timestamps()})node strut, the project CLI. Strutvane’s php artisan: make:migration, migrate, db:seed, route:list, doctor and more. It works the same in PowerShell, cmd, bash and zsh.
An automatic CRUD API and admin UI. node strut migrate gives every table with a model a REST API with search, filters, sorting and pagination, plus list, form and detail screens and a sidebar entry, behind sign-in and policies. See Your First CRUD.
The Strutvane ORM. Models are classes (class Post extends Model('posts')) with a fully typed query builder, relationships, eager loading, scopes, soft deletes and factories.
Auth built in. Email and password or email-link sign-in, email verification, password reset, two-factor authentication, passkeys, API tokens, teams and impersonation, each switched on or off in config/auth.ts. Public registration is off until you turn it on. See Authentication.
Docker or not, your choice. With Docker, everything runs in containers like Laravel Sail, and node strut forwards each command into the app container. A production Dockerfile and a dev container are written only if you ask for them. See Docker.
Pick a design. The admin UI’s look is a separate package: Crisp (the default) or Vivid, switchable later. See Designs.
Secure by default, in every style. CSRF, security headers, trusted hosts and proxies, rate limits and more are on by default, and each can be adjusted per app, route, group, controller or handler. route:list --security shows every opt-out. See Security Features and CSRF Protection.
Logging like Laravel. Channels (single, daily, stack, stderr, slack, your own) chosen in .env, with secrets always redacted. See Logging.
Built for 100+ packages. One catalogue drives the installer’s feature list and node strut install:<name>. See Package Catalogue.
npm only. No pnpm or yarn needed, anywhere.
Deprecated in 0.2
Section titled “Deprecated in 0.2”Nothing in 0.2’s own API is deprecated yet: the line hasn’t had its first release. Deprecations made during 0.2 are listed here and on the Deprecations page, and each one keeps working until at least 0.3.
Two npm names will be deprecated on npm once @strutvane/framework 0.2 is published, each with a pointer to its replacement (installing them still works, with a warning):
- the old part packages
@strutvane/core,@strutvane/contracts,@strutvane/cliand@strutvane/devkit; @strutvane/logs.
Removed and retired in 0.2 (with replacements)
Section titled “Removed and retired in 0.2 (with replacements)”| Retired | Use instead |
|---|---|
@strutvane/core |
@strutvane/framework/core. The repository was archived on 2026-11-15. |
@strutvane/contracts |
@strutvane/framework/contracts. The repository was archived on 2026-11-15. |
@strutvane/cli |
@strutvane/framework/console, run as node strut. The repository was archived on 2026-11-15. |
@strutvane/devkit |
@strutvane/framework/devkit. The repository was archived on 2026-11-15. |
@strutvane/logs |
Logging in the framework, configured from .env (Logging), plus @strutvane/log-viewer for the screen. |
The launcher and release channels (pnpm sv, the @next-only starter) |
node strut and npm create strutvane@latest. |
| The registry compiler | Migrations as the source of truth (Migrations). |
Command-line field specs (title:string(120)) |
Columns written in migrations with the Schema builder. |
upgrade and its three-way merge |
Owned files are never overwritten; auto() picks up new columns. |
| Better Auth as the default engine | @strutvane/auth’s own engine (Authentication). |
The upgrade guide shows the before and after for each one.
Shelved
Section titled “Shelved”- The Glass design was explored as a mockup and put aside on 2026-11-15 in favour of Crisp and Vivid. It is the first candidate for a future design.
Common mistakes
Section titled “Common mistakes”npm update didn’t move me to the next line
Section titled “npm update didn’t move me to the next line”Why: ^0.2.4 means “any 0.2 release from 0.2.4 on”, never 0.3. That’s on purpose: a new line may break things, so you move to it deliberately.
Fix: follow the upgrade guide, then change the range:
"@strutvane/framework": "^0.3.0"The starter refuses an old version
Section titled “The starter refuses an old version”npm create strutvane@0.1 my-appWhy: 0.1 has reached end of life, so it gets no fixes, including security fixes. The starter refuses end-of-life lines by default.
Fix: use the current line (npm create strutvane@latest my-app). If you really need the old one (for example to reproduce an old bug), pass --allow-eol:
npm create strutvane@0.1 my-app -- --allow-eolI’m reading the docs for the wrong version
Section titled “I’m reading the docs for the wrong version”Why: a search engine or an old link took you to another line’s docs.
Fix: use the version switcher at the top of the page; it keeps you on the same page when it exists. Links that start with /docs/latest/ always go to the current line.
Next steps
Section titled “Next steps”- Versioning & Support: branches, dist-tags, support windows and deprecations.
- Upgrade Guide: moving from 0.1 to 0.2.
- Package Catalogue: every package and its status.