locus

Locus Documentation

Welcome—this is the canonical guide to the Locus language, compiler, and tooling. Everything here is written for clarity and fast iteration. If something feels ambiguous, it’s a bug: open an issue or send a PR.

---

Quick Navigation

Introduction

• Language Overview
• Philosophy & Core Tenets

Getting Started & Guides

• Getting Started
• Build Outputs & Generated Files
• Authentication
• Data Relationships
• Design System Guide
• Plugins & Extensibility Guide
• Troubleshooting
• Performance & Budgets
• Snippet Validation

Language Reference

• Data Modeling
• Application Logic
• UI Syntax
• Workflows (Experimental)
• Syntax Conventions
• UI Lexical Mode & Locations

Toolchain & Operations

• CLI Reference
• Development Workflow
• Deployment

Architecture & Internals

• Architecture Reference
• Configuration Reference
• Compiler Development Plan
• Configuration Schema (JSON)

---

How to Use This Site

• New to Locus? Start with Getting Started → Data Modeling → UI Syntax.
• Prototyping features? Jump to Application Logic & Workflows (flagged experimental when relevant).
• Designing theme & tokens? Use the Design System Guide (then see UI Syntax for component binding).
• Extending or integrating? Read Plugins & the Architecture Reference.
• Operating in production? See CLI, Development Workflow, and Deployment.

Experimental modules (like Workflows) clearly mark what’s implemented vs planned so you can adopt them confidently.

---

Contributing & Feedback

Locus values precise errors and deterministic output. If you encounter unclear wording, missing examples, or discover divergence between docs and behavior, please:

1. Create an issue (include snippet + observed output), or
2. Open a PR with a concise doc patch.

We keep docs testable: many code blocks are parsed in CI. When adding new code snippets, prefer minimal, self-contained examples.

Build boldly; the compiler will tell you when you stray.

This site is open source. Improve this page.