You are browsing as a guest. Sign up (or log in) to start making projects!

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.

0
0

Comments 0

No comments yet. Be the first!