brand: introduce visual identity for bit#77
Draft
ubugeeei wants to merge 6 commits into
Draft
Conversation
Adds brand/ with logo, design tokens, icon set, brand guide, and documentation template. Concept centers on "a node, a source, a single bit" — the pink dot is the shared minimum unit between the logomark (triad of nodes) and the wordmark (i-tittle). - Palette: 5-token strict (Bit Pink #FF2D6F, off-black ink, cream paper, stone, acid). No gradients, no shadows. - Typography: Space Grotesk + Space Mono. No italic. - Logo: mark / wordmark / horizontal + stack lockups, plus inverse and monochrome variants. Geometric primitives only. - Icons: node / source / distributed / communication in the same alphabet as the mark. - preview.html shows the system end-to-end; docs/docs-template.html applies it to a documentation page. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a static documentation site under site/ deployable to GitHub Pages. Applies the bit brand: Space Grotesk + Space Mono, pink-dot wordmark, asymmetric layouts, // numbered sections, no italic, no gradients. - Landing: hero with manifesto headline, three principles, quick-start shell + embedded MoonBit example, ink manifesto strip. - Learning Guide (learn/): TOC + chapters 01 Install, 02 First commit, 03 Going distributed. - Reference (reference/): TOC + R1 CLI commands (108 commands grouped porcelain/plumbing/hub/relay/extensions/ai), R2 Library API (Storage/Fs/Kv/Hub/Node), R3 Environment. - assets/syntax.js: vanilla MoonBit syntax highlighter (keywords, preamble, types, strings, comments, function-call detection) plus shell prompt highlighting; copy buttons on every code block. - assets/site.css: docs layout (topbar/sidebar/article/TOC), brand components, pager, callouts, mobile nav. - .github/workflows/pages.yml: deploys site/ on push to main or brand, re-syncing tokens.css and logo SVGs from brand/ before upload. - site/README.md documents local preview and how to add pages. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Browsers render <em>, <i>, <cite>, <dfn>, <address>, <var>, and <q> in italic by default. Since we do not ship italic faces for Space Grotesk, the browser was synthesizing a slanted glyph — on a geometric grotesque that reads as a deformed serif, breaking the brand rule "no italic anywhere". Override globally in tokens.css and carry emphasis through font-weight + color instead. Applied to both the canonical brand tokens and the site's synced copy. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Migrates the Learning Guide and Reference pages from hand-written HTML
to markdown source under site/content/, rendered to HTML at build time
by a tiny MoonBit project that wraps mizchi/markdown.mbt.
Pipeline:
site/content/<section>/<slug>.md (author here)
│
│ moon build --target js (tools/docs-build-mbt/)
│ → render(source: String) -> String via @markdown.md_to_html
│
tools/build-docs.mjs (Node orchestrator)
│
├─ parses YAML-ish frontmatter (flat key:value)
├─ renders body through the MoonBit JS module
├─ numbers h2s, wraps code blocks in our .codeblock structure,
│ extracts TOC, generates sidenav from sibling pages
└─ writes site/<section>/<slug>.html
│
.github/workflows/pages.yml (CI)
│ installs moon, builds renderer, runs build-docs.mjs, deploys
↓
GitHub Pages
New chapter: 00 Concept — explains what bit is, what is interesting
about it, and a five-concept mental model (node / source / bit /
convergence / hub) that makes the rest of the docs fall into place.
Other notes:
- Frontmatter `lead` and `summary` strings are rendered through markdown
inline so `code` and **bold** work in the hero/TOC blurbs.
- Inline HTML in .md is the path for brand callouts:
<div class="callout"> … </div>
- Hand-written site/index.html landing is untouched — its layout is
too brand-specific to lower into markdown without loss.
- tools/docs-build-mbt/_build and .mooncakes are gitignored.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds brand/ with logo, design tokens, icon set, brand guide, and documentation template. Concept centers on "a node, a source, a single bit" — the pink dot is the shared minimum unit between the logomark (triad of nodes) and the wordmark (i-tittle).