A new tool from Moonbase 2090

Lightwell

Turning the lights on in the Dark Factory.

Open any codebase and see it as a living map: every module a block, every dependency a line, laid out for you and updated as the code changes.

Coming soon See what’s planned

In development · macOS first, then Linux · Rust first, more languages to follow

Why Lightwell

Software is being built faster than anyone can read it.

More and more code is written in the dark: generated, refactored and merged around the clock. Lightwell is the opening in the roof. Point it at a folder and the whole structure comes into view, so you can understand what was built, where it changed and how the pieces fit.

01 Live architecture map

Your codebase, laid out like a floor plan.

Open a folder and the map draws itself. Modules become blocks, dependencies become connections, and everything is arranged automatically. Zoom from the whole system down to a single module. Save a file and the map updates in place.

02 Click through to the code

From the big picture to the exact line.

Every block is a door. Click one to open its source right where it lives. A built-in, read-only code inspector is on the way, so you can read a module without leaving the map.

Inspector coming soon

core / graph.rs

// Build the module graph for a workspace
pub fn build(root: &Path) -> Graph {
    let modules = discover(root);
    let mut graph = Graph::new();
    for m in &modules {
        graph.add_block(m);
        for dep in m.imports() {
            graph.connect(m, dep);
        }
    }
    graph
}

03 Notes that live in the repo

Leave a light on for the next person.

Pin notes to any block: why it exists, what to watch out for, who to ask. Notes are saved in a small file inside your project, so they travel with the code and your team shares them through git like everything else.

.lightwell/annotations.json

04 Commit diff view

See exactly what a commit touched.

Pick a commit and the map lights up the blocks and connections it changed, while everything else falls into shadow. Review a change by its shape, not just its line count.

Coming soon

Open more light

The more you look, the more you see.

Open a folder. The map builds in seconds.
Follow a connection. See who depends on what.
Click a block. Land in the source.
Leave a note. Your team finds it on the next pull.

Rust First
TypeScript & JavaScript Next
Python Planned
Go Planned

Coming soon

First light is on its way.

Lightwell is in active development and isn’t available to download yet. It’s coming to macOS first, then Linux, starting with Rust projects.

Live architecture mapOpen a folder and watch the map draw itself.
Click through to the codeJump from any block straight to its source.
Notes in the repoPin notes to blocks and share them through git.
Commit diff viewSee the shape of a change on the map.

Downloads and install instructions will appear here when the first release is ready.

The Moonbase 2090 family