Lace repo guide

This page maps the source checkout for contributors. Tutorials and build commands live with the examples and packages they describe.

What is in the repo

Path What it is for
README.md First-contact explanation and mental model.
repo-guide.md This source-checkout and artifact map.
issues.md Active defects and unfinished contracts.
docs/README.md Documentation map.
docs/getting-started/ Human guides for a first interlace, runtime integration, and policy authoring.
docs/spec/ Authoritative numbered protocol and DX specs.
docs/architecture/ Repo-local implementation contracts below spec authority.
docs/llm-skills/ Assistant skills for writing selectors and adding Lace to apps.
core/ Runtime-neutral core plus Rust runtime/store crates.
cli/ lace command-line tool.
daemon/ laced local runtime service.
js/ Browser/JavaScript package and bundle source.
python/ Python runtime and package.
examples/ Small runnable teaching examples.
incubator/ Complete application experiments developed with the Lace runtimes in this checkout.
misc/ Non-release prototypes and secondary tools, including the command API bridge and checked-resource HTTP bridge.
scenario-tools/ Browser workbench for policy, advertisements, peer exposure views, and interlace behavior.
packages/ Archive and OS package tooling.
www/ Public website inputs and build tooling; generated output is ignored.

Where to go next

If you want... Start here
The big idea README.md
The smallest complete two-participant interlace docs/getting-started/first-interlace.md
Runtime and application setup docs/getting-started/runtime.md
Interlang selection and exposure policy docs/getting-started/policy.md
Runnable example companions examples/README.md
A local porcelain/API smoke test with memory stores examples/quickstart-local/README.md
A browser app shape with OPFS and laced over WebSocket examples/shared-todo-list/README.md
A Rust Tokio app with TCP/ILTP and filesystem stores examples/rust-tokio-tcp-fs/README.md
Substantial application designs and integration tests incubator/README.md
Policy and interlace behavior in a browser workbench scenario-tools/README.md
Browser addresses, JSONqa, and HTTP compatibility docs/spec/300-BROWSER-ADDRESSES.md, docs/spec/310-JSONQA.md, docs/spec/320-HTTP-BROWSER-COMPAT.md
The experimental checked-resource HTTP bridge misc/lace-http-bridge/README.md
Protocol truth docs/spec/

laced serves ILTP/interlace endpoints only. Serve browser HTML, CSS, JavaScript, and application command APIs with ordinary application infrastructure.