Omena documentation
Learn the semantic CSS engine through tutorials, task guides, generated reference, and design explanations.
Omena is a semantic CSS-family platform for CSS Modules, Sass, editor tooling, and evidence-aware build automation. Start with a working command, then follow the path that matches what you are trying to accomplish.
Start here
- Getting started installs the CLI and configures a workspace.
- Browser playground runs the real Rust engine locally through WASM.
- VS Code extension connects editor features to the same engine.
- SDK workflows cover NAPI, WASM, CLI, and LSP integration.
Choose by task
| Goal | Guide |
|---|---|
| Adopt Omena in an editor | Editor setup |
| Analyze Sass dependencies | External Sass and SIF compatibility |
| Plan a safe codemod | Plan and apply migrations |
| Integrate a host or SDK | SDK workflows |
| Reproduce a performance claim | Performance evidence |
| Look up an exact product contract | Generated reference |
How these docs stay accurate
Generated reference pages are rendered from product contracts. Public code examples that carry an executable fixture are run in CI; other examples are typechecked or reviewed with the site build. Release metadata is validated against an immutable release manifest. Every page also declares whether its source is authored, generated, or hybrid so readers and contributors know where a correction belongs.
Published surfaces
| Surface | Version | Channel | Availability |
|---|---|---|---|
| VS Code extension | 5.3.0 | GitHub Releases and Open VSX | Available |
| Rust CLI | 0.3.0 | GitHub Releases | Available |
| WASM SDK | 0.3.0 | npm | Available |
| NAPI SDK | 0.2.1 | npm | Available; repository source is newer |
See Compatibility and support for channel-specific limits and repository-only surfaces.
Explore the system
- Integrations separates published npm packages from APIs that exist only in repository source.
- Semantic analysis explains how parser facts become cross-file diagnostics.
- Evidence and transform safety explains why Omena preserves uncertainty instead of forcing a rewrite.
- Compatibility records the currently available registry and editor channels.