Your Site Name starter
Launch your website in 5 minutes
Download the theme, change a few lines of text and put your site online. No database, no account for the code, nothing to configure first.
- Free theme
- No coding needed
- Free hosting on Cloudflare
Stuck? See where to get help.
How to start
Five short steps from download to a live website.
Get the theme
Download the project and install it. You need Node 22.12 or newer and pnpm.
git clone https://github.com/nviewsweb/astrowebtheme-free.gitcd astrowebtheme-freepnpm installPreview it
Start the preview, then open localhost:4321 in your browser. It updates as you edit.
pnpm devMake it yours
Open
src/config/brand.mjs, search forEDITand replace the name, address, contact details and links. Swappublic/images/featured.pngfor your own picture.Write your first post
Copy a file in
src/content/blog/, change the title and the text, and save. It shows up on the blog straight away.Go live
Set
projectNameinsrc/config/wrangler.mjs, then publish with a free Cloudflare account.pnpm wrangler_jsonpnpm buildpnpm exec wrangler deploy
Want the contact form? It is off by default. Turning it on needs a handler URL and two secrets; the steps are in docs/features/contact-form.md.
What you get
Everything a small site needs, with nothing to switch on.
Fast by default
Pages are built once and served from Cloudflare, close to your visitors.
Ready for search engines
Sitemap, RSS, robots.txt and llms.txt are generated for you.
A blog in plain text
Write posts as Markdown files. Tags, categories and search work out of the box.
Light and dark mode
Visitors can switch themes, and your colours are set in one file.
Secure and private
Strict security headers and an opt-in cookie banner come built in.
Contact form ready
A form that sends email through a handler you choose. It stays off until you switch it on.
Need help?
Most questions are answered in the docs. If yours is not, ask in Discussions. Found a bug? Open an issue.
Read the docs
Every feature has a short page: what it does, which file to edit and how to check it.
Ask a question
Not sure how to do something? Search Discussions, or ask there. Ideas and sites you built are welcome too.
Report a bug
Search the open issues first. If it is new, say what you expected, what happened and your Node and pnpm versions. Known gaps are in docs/known-gaps.md.
Frequently Asked Questions
Do I need to know how to code?
No. You edit text files: one settings file for your details, and Markdown files for your posts. If you can edit a document, you can do this.
What does it cost to run?
The theme is free, and Cloudflare's free plan is enough for most small sites. The contact form is optional and off by default; the contact form doc explains what it needs.
Where is my site hosted?
On Cloudflare. Your pages are built once and delivered from servers near each visitor, so they load quickly.
What if I get stuck?
Read the docs in the repository, then ask in its Discussions. If something is broken, open an issue with the details. The Need help section below has the links.