AtharvaMoves - Stardance

Ship

@AtharvaMoves on An AI-Ready Documentation Template for Humans and AI Systems · about 1 month ago

I built Setu, an open-source documentation template for creating sites that work well for both human readers and AI systems.
Setu is built with Astro and Starlight. It supports Markdown and MDX documentation, clean navigation, searchable docs, AI-readable plain-text routes, a machine-readable document index, built-in code playgrounds, quizzes, and npm create support. The hardest part was turning the project from a content-heavy learning site into a reusable documentation template. I had to separate what belonged to the template from what was only sample content.
Another challenge was making the same source content useful in two different ways: polished pages for people, and clean plain-text output for AI tools. I also had to package the project properly so it works both as a GitHub Template and as an npm create command. I am proud that Setu is not just a visual template. It includes real developer workflow support: validation scripts, GitHub Actions, npm publishing, AI-readable output, interactive learning components, and clear open-source structure.
I am also proud that it is practical. A developer can install it, change the content, and quickly get a professional documentation or learning site online.

The easiest way to test Setu is:
npm create @rookduel/setu@latest my-site
cd my-site
npm install
npm run dev
Then open the local URL shown by Astro, usually:
http://localhost:4321
Important pages to check:
/docs/
/docs/guides/interactive-demo/
/ai/index.json
/ai/docs.txt
The normal documentation pages show the human-facing experience. The /ai/ routes show how Setu exposes cleaner text output for AI systems and retrieval workflows.

1 devlog
5h

Try project → See source code →

Open comments for this post

@AtharvaMoves on An AI-Ready Documentation Template for Humans and AI Systems · about 1 month ago

4h 30m 34s logged

Setu is an open-source documentation template built with Astro and Starlight. I created it to solve a simple problem: modern documentation should not only look good for human readers, it should also be structured enough for AI systems, search tools, and retrieval workflows to understand.
Setu gives developers a complete starting point for product docs, learning sites, internal knowledge bases, open-source documentation, and AI-readable content hubs.

What Setu Is?
Setu is a full documentation template, not just a theme. It includes the site structure, documentation pages, landing page, About page, AI-readable routes, interactive learning components, validation scripts, GitHub workflows, and npm create support.
You can start a new Setu project with:

npm create @rookduel/setu@latest my-site

Or use the GitHub repository as a public template.
How It Works
Setu uses Markdown and MDX as the content source. Pages live inside: src/content/docs/docs/
Astro and Starlight render those files into normal documentation pages under /docs/.
At the same time, Setu exposes AI-friendly versions of the same content:
/ai/index.json
/ai/docs/getting-started.txt
The JSON index helps tools discover available documents, while the .txt routes provide cleaner plain-text versions of pages for AI systems and retrieval pipelines.
Main Features
Setu includes:
Astro and Starlight documentation foundation
Markdown and MDX authoring
Responsive documentation layout
Search and navigation
Landing page and About page
AI-readable plain-text output
Machine-readable /ai/index.json
Built-in code playgrounds
Quiz components for learning pages
Starter documentation templates
GitHub issue and PR templates
CI validation workflow
npm create package
MIT License and authorship clarity
Why AI-Readable Output Matters
Most documentation sites are designed only for browsers. They often include navigation, layout markup, component code, and visual structure that is useful for users but noisy for AI systems.
Setu keeps the human-readable site while also generating cleaner text routes. This makes the same documentation easier to use in AI assistants, search systems, RAG pipelines, and automation tools.
The goal is not to replace normal docs. The goal is to make documentation useful in more contexts.
Interactive Learning Support
Setu also includes built-in interactive components. Developers can add code playgrounds and quizzes inside MDX pages.
This makes Setu useful not only for reference documentation, but also for tutorials, onboarding guides, and learning platforms.
The interactive features are part of the template by default, so users do not need to install separate extensions.
Who It Is For
Setu can be used by:
Developers building product documentation
Open-source maintainers
Educators creating technical lessons
Teams building internal knowledge bases
Projects that want AI-readable documentation
Hackathon teams that need polished docs quickly
Current Release
Setu is available as an npm create package:
npm create @rookduel/setu@latest my-site
The first public release is v0.1.0.
Repository:
https://github.com/AtharvaMoves/Setu
npm package:
https://www.npmjs.com/package/@rookduel/create-setu
Final Thought
Setu is my attempt to make documentation more useful, portable, and future-ready. It is built for people first, but structured so AI systems can read it cleanly too.