Project structure

A Stainless Docs project is an Astro project with the stainlessDocs integration configured, and inherits Astro’s file structure.

When you create a new Stainless Docs site, your repo will contain the following files and folders, which form the structure of your site and define its configuration:

📁 <root>
├─ 📁 public/
├─ 📁 src/
│  ├─ 📁 assets/
│  └─ 📁 content/
│     └─ 📁 docs/
├─ 📄 astro.config.ts
└─ 📄 package.json

Briefly:

• public/ - Static assets like your site’s favicon. These are not processed by Astro or Stainless Docs and are served at the root of your site.
• src/assets/ - Images, fonts, and other assets used in your site. Place images, videos, etc. used in your prose content here.
• src/content/docs/ - Your prose pages in Markdown, Markdoc, or MDX format.
• astro.config.ts - The primary configuration file for your project. This file contains your site’s configuration for Astro and Stainless Docs.
• package.json - Your project’s manifest file. This file contains your project’s dependencies and scripts.

In addition, there are additional support files and folders, like the README.md file, the node_modules folder, and others.

For more information about your site’s structure, have a look at Astro’s project structure documentation.