Repository navigation
docs: CLAUDE.md describes the repo the token split left behind - #52
Merged
Merged
Conversation
#51 moved every token value into packages/tokens, turned the blog into a content collection, and split the site's CSS into layers. CLAUDE.md still described the shape before that: a workspace of apps/* only, a site that was "plain Astro, static-only", posts as hand-written pages, and no mention of the package that now owns every colour. Records the four things a reader would otherwise have to rediscover: - packages/tokens is where a colour changes, and the docs light ramp is deliberately not in it - the site's CSS layers, and that primitives.css outranks a page's own <style is:global>, so a page-level override of a primitive loses silently - the three MDX traps this repo has already paid for: whitespace collapse in slotted children, markdown-parsing inside a multi-line JSX block, and smartypants rewriting authored quotes - changelog entries are curated verbatim from fold's CHANGELOG.md, so nobody writes release copy for the website Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018VbCAd3B4wuaifUTbH1s2T
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
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.
#51 moved every token value into
packages/tokens, turned the blog into a content collection, and split the site's CSS into layers.CLAUDE.mdstill described the shape before that, which matters because it is the first file a new contributor (or session) reads: a workspace ofapps/*only, a site that was "plain Astro, static-only", posts as hand-written pages, and no mention of the package that now owns every colour.What it now records
Repo map
apps/*+packages/*packages/tokensgets its own entry: change a colour there, not in an app, and the docs light ramp is deliberately not in it (hand-tuned, not a mirror of dark)apps/siteis described as it now is: MDX + sitemap, with blog and changelog as content collections that the index, feed, sitemap andllms.txtall render fromConventions — four things a reader would otherwise rediscover the hard way:
primitives.cssoutranks a page's own<style is:global>, so a page-level override of a primitive loses silently. (This one cost a debugging round during refactor(site,docs): one home for the tokens, and a collection behind the blog #51.)Closing.astro,CodePanel.astro,nav.ts(LINKS+ the header tree),seo.ts.CodePanel'scodeprop);{starts an expression, so a literal brace needs{and a pinned heading id is written\{#some-id\};smartypantsis off because it rewrote authored straight quotes and got one pair backwards.CHANGELOG.md. Nobody writes release copy for the website.Docs only, no code changes.
🤖 Generated with Claude Code
https://claude.ai/code/session_018VbCAd3B4wuaifUTbH1s2T