🔄 Modifyre Website — Complete Guide
How this site works, how to manage content, and how to publish changes.
🚀 What is Astro?
Astro is a static site generator. It takes your content files (Markdown or HTML) and builds them into plain HTML pages. The result is a fast, secure website with no database, no server, and no admin login to maintain.
Key things to know:
- No database — every page is a file on disk
- No admin panel — you edit files in VS Code or on GitHub
- Blazing fast — the built site is just HTML, CSS, and images
- Free hosting — Cloudflare Pages hosts this site for free
- Git-based — every change is tracked, easy to undo
📝 Content with Markdown (.md) Files
Instead of writing HTML, you write content in Markdown (.md) files. Markdown is a simple way to format text using plain symbols:
Markdown syntax
# Heading 1 ## Heading 2 **Bold text** and *italic text* - List item - Another item [Link text](https://example.com) 
What it looks like
Bold text and italic text
- List item
- Another item
- AI tools (like ChatGPT, Claude, Copilot) are trained on Markdown — they write it perfectly
- No risk of breaking HTML tags or layout — the AI only touches the text content
- Easy to review — Markdown is readable in any text editor or on GitHub
- Easy to migrate — you can switch between .astro and .md pages one at a time
- AI can generate entire pages from a short prompt — just describe what you want
Where content lives
Each site has a src/content/pages/ folder. Each .md file becomes one page:
src/content/pages/ index.md → Homepage (/) about.md → About page (/about) event.md → Event page (/event) contact.md → Contact page (/contact)
To add a new page, just create a new .md file in that folder.
🖼️ Adding Images, Videos, and Files
Media files go in the public/ folder. They're served as-is at the same path.
public/
assets/
images/ → /assets/images/photo.jpg
documents/ → /assets/documents/form.pdf
video/ → /assets/video/clip.mp4
fonts/ → /assets/fonts/custom.woff2 To use an image in a Markdown page:
To link a document:
[Download the form](/assets/documents/volunteer-form.pdf)
📦 The Publishing Process
Edit a file
Open any .md or .astro file in VS Code and change the text.
Save
Just save the file. That's it — no database, no admin panel.
Build & deploy
Run the deploy script. It builds the site and uploads it to Cloudflare Pages.
Live
Refresh your browser — changes are live at the pages.dev URL.
Available scripts
These scripts are in the _scripts/ folder at the repo root:
Deploy to dev (pages.dev)
bash _scripts/deploy-to-dev.sh friendly-ai.net
Builds and deploys to the Cloudflare Pages preview URL.
Publish to production
bash _scripts/publish-to-production.sh friendly-ai.net
Deploys to Pages AND reminds you to attach the custom domain.
Sync everything
bash _scripts/sync-all.sh
Commits changes to Git, pushes to GitHub, deploys both sites.
The sites are live at *.pages.dev URLs. To use your real domain
(www.friendly-ai.net, www.froodx.net), you need to
attach the custom domain in the Cloudflare Pages dashboard — one-time setup.
🙋 Volunteer Form
Interested in volunteering at Modifyre? Fill in the form below and we'll get back to you. Your information is sent directly via email — it is not stored in any database.
📂 Scraped Site Archives
Two existing event websites have been archived for reference. Their content can be compared, adapted, and migrated into the Modifyre site.
🔥 Blazing Swan
Original: blazingswan.com.au
Archive size: ~746 MB
Pages: 258 pages, 1,242 images, 56 documents
Local archive:
froodx.net/burner-webs/site-migrations/
blazing-swan-site-archive/
scraped/raw/ Browse locally:
Open Archive Index🔄 Modifyre (Original)
Original: modifyre.org
Archive size: ~36 MB
Pages: 14 pages, 24 documents
Local archive:
froodx.net/burner-webs/site-migrations/
modifyre-site-archive/
scraped/raw/ Assets (copied to prototype):
modifyre-astro-prototype/public/assets/ documents/ fonts/ images/ other/ video/
How to use the archives
- Browse the scraped sites locally using the archive index link above
- Compare content between Blazing Swan and Modifyre — see what works well
- Copy text, images, and documents into the Astro prototype
- Adapt the content for Modifyre's community and event
- Publish using the deploy scripts
Blazing Swan has a much richer archive (258 pages, theme camps, news, policies). You can use their structure as a template for Modifyre's content — for example, their theme camp directory, volunteer role descriptions, and survival guide are excellent reference material that can be adapted for Modifyre.
🟥 WordPress — The Easier Alternative
If Astro feels too technical, WordPress is a perfectly valid alternative. It's what Blazing Swan uses, and it's much easier for non-technical teams.
✅ Astro (This Prototype)
- Free hosting — Cloudflare Pages, no server costs
- No database — content is in files
- Blazing fast — pure HTML, no loading time
- Git-based — every change tracked
- AI-friendly — Markdown is perfect for AI tools
- Requires someone comfortable with files and Git
🟥 WordPress
- Paid hosting — ~$15-30/month for a basic plan
- Visual editor — drag and drop, no coding
- Admin dashboard — edit in your browser
- Plugins — forms, ticketing, galleries, SEO
- User management — multiple editors with permissions
- Familiar — many people already know how to use it
💡 Which should you choose?
Stick with Astro if: You have someone who can edit Markdown files and run the deploy script. It's free, fast, and AI tools can write content for you.
Switch to WordPress if: Multiple non-technical volunteers need to edit content, or you want a visual drag-and-drop editor. The scraped assets from both Modifyre and Blazing Swan can be imported into WordPress easily.
Hybrid option: Use Astro for the public site + a headless CMS (like Decap CMS) for visual editing. This gives you the best of both worlds — free hosting with a browser-based editor.
📋 Quick Reference
Back to Home
Return to the Modifyre prototype homepage.
Volunteer Page
View the volunteer information and form.
Site Migrations Archive
Browse scraped Blazing Swan and Modifyre content locally.