astro-site-filesv0.5.0

Showcase

Each example shows real output produced by astro-site-files itself, from files in the project repository. Input on the left, output on the right.

robots.txt

dist/robots.txtDetail →
// astro.config.mjs
site: 'https://casoon.github.io',
base: '/astro-site-files/',

// site/src/site-files.ts
export const robots: RobotsOptions = {
  // Search engines and AI assistants may read and cite the docs; training crawlers may not.
  preset: 'citationFriendly',
};
User-agent: *

User-agent: Googlebot
Allow: /

User-agent: Bingbot
Allow: /

User-agent: DuckDuckBot
Allow: /

User-agent: GPTBot
Disallow: /

User-agent: ChatGPT-User
Allow: /

User-agent: OAI-SearchBot
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: Claude-Web
Allow: /

User-agent: anthropic-ai
Allow: /

User-agent: Google-Extended
Disallow: /

User-agent: CCBot
Disallow: /

User-agent: PerplexityBot
Allow: /

User-agent: YouBot
Allow: /

User-agent: Bytespider
Disallow: /

User-agent: meta-externalagent
Allow: /

User-agent: Amazonbot
Allow: /

User-agent: Applebot-Extended
Disallow: /

User-agent: Diffbot
Disallow: /

User-agent: Omgilibot
Disallow: /

Sitemap: https://casoon.github.io/astro-site-files/sitemap.xml
  • robots
  • preset

llms.txt

dist/llms.txtDetail →
// site/src/site-files.ts
export const llms: LlmsOptions = {
  title: 'astro-site-files',
  description:
    'Astro integration that generates robots.txt, llms.txt, sitemap.xml, security.txt and humans.txt at build time from typed configuration.',
  details:
    'Published on npm as @casoon/astro-site-files. Requires Node.js 22.12 or newer and Astro 6 or newer. MIT licensed.',
  sections: [
    {
      title: 'Documentation',
      links: [
        { title: 'Installation', url: `${home}docs/getting-started/installation/` },
        { title: 'Quickstart', url: `${home}docs/getting-started/quickstart/` },
        { title: 'robots.txt', url: `${home}docs/configuration/robots-txt/`, description: 'Presets, bot groups and path rules' },
        { title: 'llms.txt', url: `${home}docs/configuration/llms-txt/` },
        { title: 'sitemap.xml', url: `${home}docs/configuration/sitemap-xml/`, description: 'Discovery, priorities, i18n and sources' },
        { title: 'RSS feed', url: `${home}docs/configuration/rss/` },
        { title: 'security.txt', url: `${home}docs/configuration/security-txt/` },
        { title: 'humans.txt', url: `${home}docs/configuration/humans-txt/` },
        { title: 'API overview', url: `${home}docs/reference/api/` },
      ],
    },
    {
      title: 'Project',
      links: [
        { title: 'Source code', url: 'https://github.com/casoon/astro-site-files' },
        { title: 'npm package', url: 'https://www.npmjs.com/package/@casoon/astro-site-files' },
        { title: 'Changelog', url: `${home}changelog/` },
      ],
    },
  ],
};
# astro-site-files

> Astro integration that generates robots.txt, llms.txt, sitemap.xml, security.txt and humans.txt at build time from typed configuration.

Published on npm as @casoon/astro-site-files. Requires Node.js 22.12 or newer and Astro 6 or newer. MIT licensed.

## Documentation

- [Installation](https://casoon.github.io/astro-site-files/docs/getting-started/installation/)
- [Quickstart](https://casoon.github.io/astro-site-files/docs/getting-started/quickstart/)
- [robots.txt](https://casoon.github.io/astro-site-files/docs/configuration/robots-txt/): Presets, bot groups and path rules
- [llms.txt](https://casoon.github.io/astro-site-files/docs/configuration/llms-txt/)
- [sitemap.xml](https://casoon.github.io/astro-site-files/docs/configuration/sitemap-xml/): Discovery, priorities, i18n and sources
- [RSS feed](https://casoon.github.io/astro-site-files/docs/configuration/rss/)
- [security.txt](https://casoon.github.io/astro-site-files/docs/configuration/security-txt/)
- [humans.txt](https://casoon.github.io/astro-site-files/docs/configuration/humans-txt/)
- [API overview](https://casoon.github.io/astro-site-files/docs/reference/api/)

## Project

- [Source code](https://github.com/casoon/astro-site-files)
- [npm package](https://www.npmjs.com/package/@casoon/astro-site-files)
- [Changelog](https://casoon.github.io/astro-site-files/changelog/)
  • llms

sitemap.xml

dist/sitemap.xmlDetail →
// astro.config.mjs
site: 'https://casoon.github.io',
base: '/astro-site-files/',

// site/src/site-files.ts
// On by default. Every page Astro builds is listed, with the base path applied.
export const sitemap: SitemapOptions = {};
<?xml version="1.0" encoding="UTF-8"?>
<!-- Generated by @casoon/astro-site-files -->
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://casoon.github.io/astro-site-files/changelog/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.9</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/configuration/humans-txt/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/configuration/llms-txt/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/configuration/robots-txt/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/configuration/rss/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/configuration/security-txt/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/configuration/sitemap-xml/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/getting-started/installation/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/getting-started/quickstart/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/guides/audit/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/guides/site-url-and-base/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.9</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/docs/reference/api/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/showcase/robots-txt/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.8</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/showcase/llms-txt/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.8</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/showcase/sitemap-xml/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.8</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/showcase/security-txt/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.8</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/showcase/humans-txt/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.8</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/showcase/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.9</priority>
  </url>
  <url>
    <loc>https://casoon.github.io/astro-site-files/</loc>
    <lastmod>2026-09-27</lastmod>
    <changefreq>weekly</changefreq>
    <priority>1.0</priority>
  </url>
</urlset>
  • sitemap

security.txt

dist/.well-known/security.txtDetail →
// site/src/site-files.ts
export const security: SecurityOptions = {
  contact: 'mailto:info@casoon.de',
  // RFC 9116 recommends less than a year; every build moves the date forward.
  expires: new Date(Date.now() + 180 * 24 * 60 * 60 * 1000),
  preferredLanguages: ['en', 'de'],
  canonical: `${home}.well-known/security.txt`,
};
Contact: mailto:info@casoon.de
Expires: 2027-03-26T15:09:41.022Z
Preferred-Languages: en, de
Canonical: https://casoon.github.io/astro-site-files/.well-known/security.txt
  • security
  • rfc 9116

humans.txt

dist/humans.txtDetail →
// site/src/site-files.ts
export const humans: HumansOptions = {
  team: [{ name: 'Jörn Seidel', role: 'Author and maintainer' }],
  technology: ['Astro', 'TypeScript', '@casoon/astro-site-files', '@casoon/pages-theme'],
  note: 'This file, robots.txt, llms.txt, sitemap.xml and security.txt are generated by @casoon/astro-site-files during the site build.',
};
/* TEAM */
    Name: Jörn Seidel
    Role: Author and maintainer

/* SITE LAST UPDATED */
    2026-09-27

/* TECHNOLOGY COLOPHON */
    Astro, TypeScript, @casoon/astro-site-files, @casoon/pages-theme

/* NOTE */
    This file, robots.txt, llms.txt, sitemap.xml and security.txt are generated by @casoon/astro-site-files during the site build.
  • humans