## 1. Project Overview & Quickstart (btraceio/CLAUDE) ## 1. Project Overview & Quickstart (btraceio/CLAUDE) # Technical Documentation: btraceio/CLAUDE > ℹ️ **Provenance:** Multi-Tier Ingestion · [CodeWiki Reference](https://codewiki.google/github.com/btraceio/CLAUDE) # CLAUDE ### Agent Skills & Rules - Discovered 21 agent rule(s) and prompt configurations. --- METRICS --- - Files Extracted: 1 - Estimated Token Budget: ~24 tokens - Canonical Reference: https://codewiki.google/github.com/btraceio/CLAUDE ## 2. Official Technical Reference & Guides (btraceio/btraceio.github.io) ## File: README.md # btraceio.github.io Landing page for the [btraceio](https://github.com/btraceio) GitHub organization, served at https://btraceio.github.io/. Plain static HTML. No build step, no Jekyll (`.nojekyll`). | Path | Content | | --- | --- | | `index.html` | The page. Project cards carry static fallback values. | | `assets/site.css` | Page styles (dark CRT variant of the Modernist design system). | | `assets/modernist.css` | Modernist design-system tokens and base components. | | `assets/org.js` | Fetches stars, latest release and 52-week commit activity from the GitHub API. Caches for 1 hour in `localStorage`. | | `icon/` | BTrace 3.0.0 icon set (SVG + PNG sizes). | ## Preview locally ```sh python3 -m http.server 8000 # open http://localhost:8000/ ``` ## Add a project 1. Copy an `
` block in `index.html`, set `data-repo` to the repo name and update the copy and fallback values. 2. Add the repo name to `REPOS` in `assets/org.js`. 3. Update `active projects: N` in the hero. ## Publish Repository **Settings → Pages → Build and deployment**: source *Deploy from a branch*, branch `main`, folder `/ (root)`. --- ## File: CLAUDE.md # btraceio.github.io Static org landing page. See README.md for layout. No build; verify by serving the root (`python3 -m http.server`) and checking desktop + 390px width with no horizontal scroll. ## BTrace design language Use this for all BTrace / btraceio work unless told otherwise. - Base: Modernist design system tokens (`assets/modernist.css`), inverted to a dark ground. Page bg `var(--color-text)`, text `var(--color-bg)`, deep panels `color-mix(in oklch,var(--color-text),black 45%)`. - Accent: `var(--color-accent)` red used as neon (glow via text-/box-shadow); small red text uses `--color-accent-400` on dark. - Texture: fixed CRT scanlines + slow scan sweep, 64px faint grid on main, HUD corner brackets on key panels, red scrolling ticker at top. - Type: Oxanium 700 uppercase for display/headings; JetBrains Mono for labels, buttons, code, terminals; Archivo for body copy. - Structure: zero radius, 2px rules (`--color-neutral-800/700`), flush-left everything, section kickers like `// 02 // Start here`, `[01]` numbering. - Motion: expressive scroll reveals, glitch on hero headline; respect prefers-reduced-motion. - Icon: "Frames and probe" — files in `icon/` (use `btrace-icon-small.svg` at ≤48px). - Copy: ASD-STE100 Simplified Technical English — short sentences, one topic each, active voice, no -ing nouns/adjectives, no phrasal verbs or contractions, consistent terms (live JVM, attach, detach, remove the probe). ## 2. Official Technical Reference & Guides (btraceio/btraceio.github.io) ## File: README.md # btraceio.github.io Landing page for the [btraceio](https://github.com/btraceio) GitHub organization, served at https://btraceio.github.io/. Plain static HTML. No build step, no Jekyll (`.nojekyll`). | Path | Content | | --- | --- | | `index.html` | The page. Project cards carry static fallback values. | | `assets/site.css` | Page styles (dark CRT variant of the Modernist design system). | | `assets/modernist.css` | Modernist design-system tokens and base components. | | `assets/org.js` | Fetches stars, latest release and 52-week commit activity from the GitHub API. Caches for 1 hour in `localStorage`. | | `icon/` | BTrace 3.0.0 icon set (SVG + PNG sizes). | ## Preview locally ```sh python3 -m http.server 8000 # open http://localhost:8000/ ``` ## Add a project 1. Copy an `
` block in `index.html`, set `data-repo` to the repo name and update the copy and fallback values. 2. Add the repo name to `REPOS` in `assets/org.js`. 3. Update `active projects: N` in the hero. ## Publish Repository **Settings → Pages → Build and deployment**: source *Deploy from a branch*, branch `main`, folder `/ (root)`. --- ## File: CLAUDE.md # btraceio.github.io Static org landing page. See README.md for layout. No build; verify by serving the root (`python3 -m http.server`) and checking desktop + 390px width with no horizontal scroll. ## BTrace design language Use this for all BTrace / btraceio work unless told otherwise. - Base: Modernist design system tokens (`assets/modernist.css`), inverted to a dark ground. Page bg `var(--color-text)`, text `var(--color-bg)`, deep panels `color-mix(in oklch,var(--color-text),black 45%)`. - Accent: `var(--color-accent)` red used as neon (glow via text-/box-shadow); small red text uses `--color-accent-400` on dark. - Texture: fixed CRT scanlines + slow scan sweep, 64px faint grid on main, HUD corner brackets on key panels, red scrolling ticker at top. - Type: Oxanium 700 uppercase for display/headings; JetBrains Mono for labels, buttons, code, terminals; Archivo for body copy. - Structure: zero radius, 2px rules (`--color-neutral-800/700`), flush-left everything, section kickers like `// 02 // Start here`, `[01]` numbering. - Motion: expressive scroll reveals, glitch on hero headline; respect prefers-reduced-motion. - Icon: "Frames and probe" — files in `icon/` (use `btrace-icon-small.svg` at ≤48px). - Copy: ASD-STE100 Simplified Technical English — short sentences, one topic each, active voice, no -ing nouns/adjectives, no phrasal verbs or contractions, consistent terms (live JVM, attach, detach, remove the probe).