3.4 KiB
Repo facts (gathered directly, 2026-09-06)
Ground truth for the other research notes. Everything here was read off disk, not inferred.
The four repos
| App | Directory | Git remote | Commits | Uncommitted files |
|---|---|---|---|---|
| Margin (writing studio) | python/margin |
[email protected]:priyanshujain/margin.git |
149 | 1 |
| Margin Calendar | python/margin-caledar |
[email protected]:priyanshujain/margin-calendar.git |
27 | 0 |
| Margin Docs | rust/margin-editor |
[email protected]:priyanshujain/margin-docs.git |
8 | 123 |
| Margin Mail | rust/margin-mail |
none configured | 1 | 123 |
All paths are relative to /Users/pj/Workspace/projects.
Three names disagree with themselves. The calendar's directory is misspelt (margin-caledar), the
docs app lives in a directory called margin-editor while its package is margin-docs and its
remote is margin-docs, and the two Rust-family apps sit under rust/ while the two older ones sit
under python/ for no reason that survives inspection. None of the four is a Python project.
Margin Mail has no remote and a single scaffold commit with 123 files of uncommitted work on top of
it. Margin Docs has 123 uncommitted files. Any plan that starts by moving files between repos has to
deal with that first: see the sequencing note in ../migration.md.
There is no separate website repo on disk. The Astro site lives at python/margin/website.
Size
| App | TS/TSX/CSS files | TS lines | Rust files | Rust lines |
|---|---|---|---|---|
| Margin | 72 | 10,871 | 12 | 2,190 |
| Margin Calendar | 100 | 15,517 | 20 | 8,490 |
| Margin Docs | 151 | 43,311 | 14 | 5,365 |
| Margin Mail | 172 | 31,409 | 98 | 45,884 |
About 101,000 lines of front end and 62,000 lines of Rust across the four.
The shared package as it stands
python/margin/shared is a real npm package named margin-shared, tracked in Margin's git repo
(26 files). It has no build step and no dependencies: consumers resolve its TypeScript source
directly through Vite. It contains css/tokens.css, css/fonts.css, src/fonts.ts (233 lines),
src/icons.ts (61 lines), src/index.ts, twelve variable font binaries with their licences, and
bin/sync-fonts.mjs, which copies those binaries into a consuming app's public/fonts.
Margin depends on it as "margin-shared": "file:./shared". Margin Docs and Margin Mail both depend
on it as "margin-shared": "file:../../python/margin/shared", a path that walks out of the
repository and into a sibling checkout. On this machine pnpm has resolved that to a symlink and it
works. On a fresh clone it does not: pnpm install in Margin Docs fails unless Margin happens to be
checked out at exactly that relative location, which no CI runner and no other person will reproduce.
Margin Calendar does not depend on it at all and carries its own copies of the same tokens.
This is the single fact that motivates the whole exercise. The shared package is the right idea executed in a way that only works on one laptop.
Toolchain in use
pnpm 10.12.4, Node 25.5.0, cargo and rustc 1.96.1. React 19.1, Vite 7, TypeScript 5.8, Tauri 2, zustand 5 in all four apps. No prettier anywhere. No eslint anywhere.
CLAUDE.md files
Only Margin and Margin Calendar have one, 16 lines each. Margin Docs and Margin Mail have none, so
everything those two projects have learnt lives in assistant memory files outside the repos, which is
exactly what guidelines/ is for.