Line 01 · Codebase tours

Every codebase has a line through it.

Gitrailway reads the repo and draws one line through it: the files a senior dev would show you, in order, with a note at each stop and a marker that says you are here.

No accounts · No waitlist · Open source — when it ships.

01No forms
02No waitlist
03No account
04Open sourceYou are here
The line

Most repos keep the map in one person's head.

The knowledge lives with a senior dev, or in a README that went stale three years ago. Gitrailway reads the repo itself and draws one line through it.

Stn 01 · entry

Ordered like a senior dev

Entrypoints first, core next, corners last. The line follows how the code is actually used, not the folder tree.

Stn 02 · notes

A note at every stop

Each station explains what the file does and why it matters, short enough to read before you open it.

Stn 03 · position

You always know where you are

Every step carries a marker: done, here, next. The map updates as you move. No getting lost in a 40-file repo.

How it works

How a line gets drawn.

Three beats per repo. Nothing to configure, nothing to install in your project.

01

You open a repo

Point Gitrailway at any repo, local or public. No config file, no setup step.

02

The line draws itself

Gitrailway reads structure, history and tests, then orders the files the way a maintainer would show them.

03

You ride it

Each stop explains one file. Mark it done and the line continues. Get lost, ask for a detour.

Who it's for

One line, three kinds of reader.

A route through a repo helps different people in different ways. Here is who the line was drawn for.

First day on a new project

Instead of hunting through folders, ride one line and arrive knowing the shape of the repo — where the code starts, what it touches, and where it ends.

Your own repo, six months later

Memory goes stale; git history doesn't. The line is rebuilt from the current repo, so it shows where things actually live now.

Teams getting people up to speed

Onboarding becomes: ride the line, ask questions at the stops, keep moving. A map that can't rot in a drawer.

Stops we skip

What never gets a station.

If a feature makes a dev tool look good in a screenshot but slows down the person using it, the line goes around it.

Questions

Stops people ask about.

The short version: Gitrailway reads the repo, never touches it, and ships without a signup wall.

Do I have to install anything in my repo?

No. Gitrailway reads the repository read-only — structure, history, tests. Nothing is added to your project: no config file, no dependencies, no CI step.

Is Gitrailway an editor?

No. The line points at the code; you read it in the editor you already use. Gitrailway is the map, not the territory.

What does it look at to draw the line?

File structure, git history and tests. From those it finds the entrypoints, the order the code actually runs in, and the files that prove the behaviour works.

Can I use it on private repos?

Yes. Local and private repos are first-class citizens. Nothing leaves your machine unless you choose to share a line.

What happens when the repo changes?

Lines are rebuilt from git history, so they refresh as the repo moves. Stale stops get retired, new ones get drawn in — no hand-maintained tours.

When does it ship?

The build is public on X at @gitrailway. When it opens, it opens — no waitlist, no forms, nothing to sign up for.

Launch

The build is public.

Follow the project on X. When Gitrailway opens, it opens. No forms, no waitlist, nothing to sign up for. You'll already be following the people who built it.

Follow @gitrailway on X ↗