the claude code sourcemaps leaked march 31
add documentation site
+12
-16
+7
-10
README.md
+7
-10
README.md
···
123
123
124
124
Full internals documentation (architecture, workflows, official-docs cross-reference, subsystem reference, appendices) is built with **MkDocs Material** from [`docs-site/`](docs-site/).
125
125
126
-
- **Live site:** after you enable GitHub Pages on the `gh-pages` branch, the site is served at
127
-
`https://<your-github-user>.github.io/claude-code-source-code/`
128
-
(replace with your fork’s user/org and repo name).
126
+
- **Live site:** [https://mehmoodosman.github.io/claude-code-source-code/](https://mehmoodosman.github.io/claude-code-source-code/)
129
127
- **Local preview:** `cd docs-site && python3 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt && mkdocs serve`
130
128
- **Publish:** pushing to `main` runs [`.github/workflows/pages.yml`](.github/workflows/pages.yml) and deploys to `gh-pages`.
131
129
132
-
Update `site_url` and `repo_url` in [`docs-site/mkdocs.yml`](docs-site/mkdocs.yml) after the first deploy so canonical URLs match your fork.
130
+
Canonical `site_url` and `repo_url` are set in [`docs-site/mkdocs.yml`](docs-site/mkdocs.yml) for this deployment. Forks should change those values to match their own GitHub user/org and Pages URL.
133
131
134
132
**Contributing to docs:** edit Markdown under `docs-site/docs/`; keep the [official docs map](docs-site/docs/official-docs-map.md) in sync with [Anthropic’s docs index](https://code.claude.com/docs/llms.txt) when adding major features.
135
133
136
-
### Next steps (first-time publish)
134
+
### Next steps (forks / new clones)
137
135
138
-
1. **Commit and push** this repository to GitHub (`main` must contain `docs-site/` and `.github/workflows/pages.yml`).
139
-
2. **Allow the workflow to run** — GitHub Actions → _Deploy documentation to GitHub Pages_ → confirm it completes (or run **Run workflow** manually).
140
-
3. **Turn on Pages** — Repository **Settings → Pages** → **Build and deployment** → Source: **Deploy from a branch** → Branch **`gh-pages`** / folder **`/ (root)`**. (If you prefer the newer “GitHub Actions” source, switch the workflow to `actions/upload-pages-artifact` + `deploy-pages` instead of peaceiris.)
141
-
4. **Set `site_url`** in [`docs-site/mkdocs.yml`](docs-site/mkdocs.yml) to your live URL (e.g. `https://YOUR_USER.github.io/claude-code-source-code/`) and push again so sitemaps and search use the correct base.
142
-
5. **Fork-specific URLs** — Update `repo_url`, `edit_uri`, and the `extra.social` GitHub link in `mkdocs.yml` if this is not `marium/claude-code-source-code`.
136
+
1. **Commit and push** so `main` includes `docs-site/` and `.github/workflows/pages.yml`.
137
+
2. **Run the Pages workflow** (or wait for it on push).
138
+
3. **Settings → Pages** → deploy from branch **`gh-pages`** / **`/ (root)`** (unless you switch to the GitHub Actions Pages source).
139
+
4. Set **`site_url`** in `mkdocs.yml` to your live URL and align **`repo_url`** / **`extra.social`** with your fork, then push to refresh the site.
143
140
144
141
## Repository layout
145
142
+1
-1
docs-site/docs/index.md
+1
-1
docs-site/docs/index.md
···
27
27
28
28
## Repository
29
29
30
-
Source code lives under `src/` in the GitHub repository. The published MkDocs site is built from `docs-site/` via GitHub Actions. After enabling Pages on the `gh-pages` branch, the URL is typically `https://<user>.github.io/<repo>/` (see the root `README.md`).
30
+
Source code lives under `src/` on GitHub ([mehmoodosman/claude-code-source-code](https://github.com/mehmoodosman/claude-code-source-code)). This site is published at **[https://mehmoodosman.github.io/claude-code-source-code/](https://mehmoodosman.github.io/claude-code-source-code/)** via GitHub Actions from `docs-site/`.
+1
-1
docs-site/docs/installation.md
+1
-1
docs-site/docs/installation.md
···
27
27
On push to `main`, the workflow `.github/workflows/pages.yml` builds the site and pushes to the `gh-pages` branch (also runs when `README.md` or the workflow file changes).
28
28
29
29
1. In the GitHub repo: **Settings → Pages → Build and deployment → Branch `gh-pages` / `/ (root)`**.
30
-
2. After the first deploy, set `site_url` in `docs-site/mkdocs.yml` to your real Pages URL (e.g. `https://<user>.github.io/<repo>/`) so canonical links and search work correctly. Also update `repo_url` if your fork uses a different owner or name.
30
+
2. Set `site_url` in `mkdocs.yml` to your real Pages URL (this fork uses `https://mehmoodosman.github.io/claude-code-source-code/`) and keep `repo_url` aligned with your GitHub owner so “edit” links and sitemaps stay correct.
31
31
32
32
The deploy step sets **`enable_jekyll: false`** so GitHub Pages serves static files correctly (adds `.nojekyll`).
33
33
+3
-4
docs-site/mkdocs.yml
+3
-4
docs-site/mkdocs.yml
···
1
-
# Set site_url after first GitHub Pages deploy, e.g. https://YOUR_USER.github.io/claude-code-source-code/
1
+
site_url: https://mehmoodosman.github.io/claude-code-source-code/
2
2
site_name: Claude Code internals (recovered source)
3
3
site_description: Architecture and code reference for the reconstructed Claude Code CLI tree, cross-linked to official Anthropic docs.
4
4
site_author: Repository maintainers
5
5
6
-
# Update for your fork:
7
-
repo_url: https://github.com/marium/claude-code-source-code
6
+
repo_url: https://github.com/mehmoodosman/claude-code-source-code
8
7
repo_name: claude-code-source-code
9
8
edit_uri: edit/main/docs-site/docs/
10
9
···
84
83
extra:
85
84
social:
86
85
- icon: fontawesome/brands/github
87
-
link: https://github.com/marium/claude-code-source-code
86
+
link: https://github.com/mehmoodosman/claude-code-source-code