astro-knots/reminders
- Path
- reminders/index.md
Reminders
- Astro Frontmatter: Avoid Inline Block Comments and Risky Regex Literals - In
.astrofrontmatter, a/* */comment after a statement lexes as a regex literal — the error reports a column past EOF. Use//. - Astro Knots is not a True Monorepo - A reminder that Astro-Knots is organized like a monorepo but functions as a collection of independent Astro projects for convenient pattern porting.
- Dates are UTC at rest, viewer-local at render
- Design System Pages Per Site - Every site should have a design-system route with browsable pages for components, flare, and layouts — built with zero-friction by Code Assistants, not a third-party documentation tool.
- Flare Components — Creative Workflow - Flare is our naming convention for design-oriented components — images, illustrations, and animations as code. This reminder covers naming, preferred tech, and the creative brief workflow.
- Improvising within Design System Color Palettes - A reminder to AI code assistants and developers: use named colors and design tokens; when improvising raw hex or rgba values, reintegrate them into the system.
- Orient Before You Introduce a Term of Art - A reader who does not yet know what the thing is cannot learn its name. Plain question first, clinical title second — enforce it in the schema.
- Preference for Shortcuts in Config to Absolute Paths -
../../../components/basics/DeckHeader.astrobreaks the moment you move the importer;@components/…reads the same from anywhere. - Preferred Stack - A quick reference for the preferred technology stack: HTML/CSS first, Astro for SSG, Svelte for interactivity, Tailwind for styling, and no React.
- Quirks of Obsidian Flavored Markdown - A quick reference for the quirks of Obsidian Flavored Markdown.
- Rule to Assure Collection Schema is Flexible - A lenient Zod schema doesn’t remove the failure, it moves it — the build goes green and the date renders blank instead.
- Tags Must Use Train-Case - All tags in YAML frontmatter must use Train-Case — capitalize each word, hyphens between words, no spaces, no underscores, no all-lowercase.
- Wrap Long String Values in Double Quotes - Long YAML string values — descriptions, titles with punctuation, URLs with query strings, ledes — should always be wrapped in double quotes. Cheap insurance against the entire class of YAML-syntax-collision bugs.
- Write a Changelog Prior to Meaningful Commits - A quick reference for writing a changelog prior to meaningful commits.
- YAML Frontmatter Parsing Must Be Lenient - Across every Astro Knots site, content frontmatter parsing must tolerate messy YAML — log a warning and skip the file, never fail the whole build. No strict YAML parsers, ever.