This is the codebase for the Fragments & Flows website.
Built using Astro.
Digital garden posts are written in Markdown and are located in content/garden. Just add a new markdown file there and it will get a URL corresponding to the file name and appear in the garden posts list. Make sure to set the metadata properly, defined at the top of the Markdown file (before the actual Markdown).
When updating posts, it's good to set the updated-at date manually in the metadata (this hasn't yet been automated).
These are the basic commands used for development:
| Command | Action |
|---|---|
npm install |
Installs dependencies |
npm run dev |
Starts local dev server at localhost:4321 |
npm run build |
Build your production site to ./dist/ |
npm run preview |
Preview your build locally, before deploying |
Astro is opinionated in how you add routes, so it's good to familiarize with file-based routing if you want to add a new page.
Astro Content Collections are used for defining and loading the digital garden posts.
The website is currently deployed to Netlify using the relevant Netlify Adapter. Every time you push to the main branch, a fresh Netlify deployment is triggered (there is an integration between GitHub and Netlify).