Chips'nCode

Astro-powered personal site for technical writing, projects, tools, education resources, poetry, and astrophotography.

Live deployment is served via GitHub Pages.

Stack

• Astro 5
• Astro Content Collections (Markdown/MDX)
• GitHub Actions + GitHub Pages deployment

Content Collections

Content is managed in src/content/:

• blog
• docs
• projects
• tools
• education
• poetry
• astrophotography

Collection schemas and validation live in src/content.config.ts.

Local Development

Run all commands from repository root:

Command	Action
npm install	Install dependencies
npm run dev	Start local dev server
npm run build	Build static site to dist/
npm run preview	Preview production build locally

Publishing Workflow

1. Add or edit content in the relevant src/content/<collection>/ directory.
2. Include frontmatter fields expected by the schema (for example: title, description, pubDate, tags, optional updatedDate, optional featured).
3. Run npm run build before pushing.
4. Push to master to trigger deployment.

Tags are normalized to slug routes under /tags/<tag-slug>/.

CLI Index Shell

The reusable shell component lives at:

• src/components/CliShell.astro

It is used on:

• /docs
• /projects
• /tools
• /notebook

Notes:

• Supports unix-style commands (stat, ls, cd, grep, tag, man, etc.)
• Supports per-command help via --help / -h
• Manual drawer includes keyboard navigation and clickable SEE ALSO
• Hidden on mobile breakpoints to keep index pages lightweight

Deployment

• Primary branch: master
• Deployment target: GitHub Pages
• Build output: static files in dist/

If deployment fails, check the GitHub Actions workflow logs in the repository Actions tab.

Domain and DNS

Custom domain DNS is managed outside this repo (Squarespace DNS host), while site hosting is GitHub Pages.

Repository Layout

.
├── public/
├── src/
│   ├── components/
│   ├── content/
│   ├── layouts/
│   ├── pages/
│   └── utils/
├── astro.config.mjs
├── package.json
└── README.md