Content-first rebuild of phi9.space using Astro, Tailwind, and Markdown collections to support a heavy publishing cadence.
- Layout grid with 25vw / 50vw / 25vw structure, responsive fallbacks, and persistent Human ⇄ AI view toggle stored in
localStorage. - Content collections (
pages,blog) with tag support, Markdown styling, code block highlighting, and Obsidian-friendly frontmatter. - SEO tooling including structured data, sitemap generation, RSS feed, and social cards rendered at build time.
- Component library for navbar, footer, latest-feed rail, tag filters, and Markdown rendering with dual-mode output.
- Glass surfaces standardized via
.glass-panel,.glass-tile, and.glass-chiputility classes for reusable frosted UI treatments (dark-mode aware). - Future-ready shader slot exposing an
AsciiShadercomponent for upcoming WebGL experiments without blocking launch.
npm install
npm run devnpm run dev– start local development servernpm run build– generate the production build indist/npm run preview– preview the built site locallynpm run lint– runastro checkto validate content collections and TypeScript
- Markdown files live in
src/content/pages(static sections) andsrc/content/blog(posts). - Blog posts require
title,description,pubDate, and optionaltags,updatedDate,heroImagefrontmatter. - Page frontmatter extends Markdown with
heroSubtitle,updated, andnavTitlefields so navigation copy stays consistent. - Assets (logos, favicons) remain in
public/.
- Create
src/content/pages/<slug>.mdwith frontmatter + Markdown content. - Duplicate an existing page template (like
src/pages/research.astro) or create a new Astro page that imports the entry viagetEntry('pages', '<slug>'). - Update
src/components/Navbar.astroif the new page should appear in navigation.
- Create
src/content/blog/<slug>.mdwith the required frontmatter and Markdown body. - Run
npm run devto preview; the post is automatically routed to/blog/<slug>/. - Add
tagsto control filters in the blog index—keep them simple (e.g.research,updates).
Refer to TODO.md for outstanding tasks including the ASCII shader rollout and enhanced AI view features.