mirror of
https://github.com/priyanshujain/margin.git
synced 2026-10-05 04:27:03 +00:00
66 lines
3.4 KiB
Markdown
66 lines
3.4 KiB
Markdown
# 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.
|