Home

Somnia user guide

The user guide explains how to use Somnia. It is the front door for people who use the app. Technical design, architecture and decision records stay in the rest of docs/ and are linked from here.

Status labels

Every page states what is shipped and what is not. We use three labels and nothing else.

Label	Meaning
Stable	In the latest stable release on GitHub Releases.
Pre-release	In an alpha or beta of the current line. Can change or break. Not in the latest stable.
In development	Concept or branch only. Do not rely on it.

A passing test, a merged branch or a mock-server run does not move a feature to Stable. Only a published release does.

Pages

Start here	Page
Install, open a project, first save	Quickstart
What each studio does and where its docs are	Studios
The primary button next to Account	Header hero actions
Publish a site over SSH or FTP	Deploy
React, Vue, Svelte, Next, Astro and more	Frameworks
somnia run, background runs, exit codes	Command line
Add commands, panels and themes	Extensions
Where options live	Settings
Run AI on your own machine	Local AI
Something broke	Troubleshooting
Quick answers	FAQ
What exists in the editor	Features
Search selected open text locally	Local source search
AI and collaboration	AI and collaboration
Versions and roadmap	Releases

Rules for writing docs

See DOCS-STYLE.md. The short version: English, one home per topic, link instead of copy, state the status, no real keys, hosts or personal data in examples.

Latest stable

Somnia 12.2.0 is the first stable release of the 12.2 line. Built from the green full-matrix run on 81497996. The custom Windows setup stays an unsigned preview.