Home

Lexicon Wiki

Lexicon is a Swift package, document format, CLI, language server, and code-generation toolkit for turning domain language into a living semantic graph.

Use the README as the short project overview. Use this wiki when you need step-by-step setup, generator details, editor integration, or examples you can adapt in a real codebase.

Start Here

• Quick Start - create a lexicon, validate it, search it, generate code, and enable editor support.
• Core Concepts - document, graph, lexicon, lemma, type, synonym, default, note, and comment.
• Gardening Philosophy - how Lexicon turns the Garden manifesto into documentation and tooling practice.
• Vocabulary Workflows - before/after refactors, review checklists, semantic UI, analytics, support, operations, and proposal templates.
• Document Syntax - every TaskPaper-style construct with examples.
• Composition and Imports - split a vocabulary across files without losing meaning.
• CLI Reference - validation, linting, search, tree views, refs, formatting, diffs, edits, and the REPL.
• Editor Support - what lexicon-lsp supports and how editor integrations attach to it.
• Commerce Example - a multi-file API, UI, session, UX, and support vocabulary.

Language Guides

Each generated target has its own page with setup, commands, and usage examples:

• Swift
• Kotlin
• Go
• Rust
• TypeScript
• JSON and SKOS JSON-LD

Common Workflows

• Code Generation - choose a target and wire generation into a build.
• Search - hybrid, semantic, token, and lexical search modes.
• Project Configuration - lexicon-lsp.json and multi-root workspaces.
• Runtime Events - generated Swift lexicons with async event streams.
• Platform Support - macOS, Linux, Android, NaturalLanguage, and MLX notes.
• Troubleshooting - the failure modes that usually cost time.