Frequently asked questions
Straight answers.
Can't find your question? Ask on GitHub and we'll answer it here.
What is vagejs?
vagejs is a free, open-source framework for building websites. You write pages as simple text files, and it turns them into a fast website with search-engine and AI-friendly files already built in.
Is vagejs free?
Yes. It's released under the MIT license, so you can use it for personal and commercial sites at no cost.
Do I need to know how to code?
A little comfort with a terminal helps. Writing pages only takes plain text, and AI coding assistants like Claude Code can set up and update a site for you.
How is it different from WordPress?
WordPress runs a database and server code every time someone visits. vagejs builds plain pages ahead of time, so there's no database to secure or update. There's no admin dashboard either; your content lives in text files.
Will vagejs help my site rank on Google?
It takes care of the technical side: sitemaps, page summaries, structured data, speed and broken-link checks. Rankings still depend on your content and on other sites linking to you, and no tool can guarantee them.
Does it work with ChatGPT, Claude and other AI search?
It creates llms.txt, a plain guide to your site for AI tools, and lets you choose which AI crawlers may visit. Whether an AI assistant mentions your site is up to that assistant.
How does vagejs protect my site from spam?
Links to websites you haven't approved, and links hidden from visitors, stop the build. vage verify compares your live site with your files, so injected links, scripts or pages show up quickly.
Where can I host a vagejs site?
Anywhere that serves files. Cloudflare Workers and GitHub Pages have one-command publishing built in, and any other static host works too.
How much does hosting cost?
Often nothing. A vagejs site is a folder of files, and Cloudflare and GitHub Pages both host static sites on free plans within their limits.
Can AI coding assistants build a vagejs site?
Yes. Every site includes instructions that Claude Code, Codex, Cursor, Copilot and other agents read, and every command can answer in JSON. You still approve publishing and new outside links.
Is vagejs ready for production?
vagejs is young (0.x) and this website runs on it. The site it builds is plain HTML, so it's as stable as your host. Read the changelog before upgrading, because 0.x releases can change behavior.
What do I need to get started?
Node.js 22.12 or newer. Then run npm create vagejs@latest my-site and follow the three steps it prints.
Start with one command.
You'll have a site running in a minute.
npm create vagejs@latest my-site