Creative Coding Gallery

A static gallery site showcasing generative art and creative coding experiments. Built with Astro, deployed on GitHub Pages.

Live: amycardoso.github.io/creative-coding-gallery

How it works

The gallery fetches sketch metadata from a manifest.json in the creative-coding source repo at build time. Media files (GIFs, PNGs) are served directly from GitHub's raw content CDN.

creative-coding repo                    creative-coding-gallery repo
┌──────────────────┐                    ┌──────────────────────────┐
│ Push manifest.json│ ──dispatch──────> │ GitHub Actions triggered  │
│ or new sketch    │                    │ 1. Fetch manifest.json   │
└──────────────────┘                    │ 2. Build Astro site      │
                                        │ 3. Deploy to GH Pages   │
                                        └──────────────────────────┘

Adding a new sketch

1. Add the sketch folder with media to the creative-coding repo
2. Add an entry to manifest.json
3. Push — the gallery rebuilds automatically

Development

npm install
npm run dev

Tech stack

• Astro 5 — static site generation, zero client-side JS
• Zod — build-time validation of sketch metadata
• GitHub Actions — CI/CD with automatic deploys on push, dispatch, and weekly schedule

License

MIT