@qalisa/vike-plugin-sitemap/README.md

An unofficial Vike plugin to automagically generate sitemap and robots.txt files

# Vike Sitemap Plugin

A Vike plugin for handling `sitemap.xml` and/or `robots.txt` file generation automatically, based on your project structure.

## Features
- Automatically generates a `sitemap.xml` based on your `pages/` directory.
- Supports custom sitemap entries.
- Generates a `robots.txt` file with configurable rules.
- Updates in development mode when files change.
- Fully configurable options.

## Installation

```sh
npm install -D @qalisa/vike-plugin-sitemap
```

or

```sh
yarn add --dev @qalisa/vike-plugin-sitemap
```

or

```sh
pnpm install -D @qalisa/vike-plugin-sitemap
```

## Usage

In your Vike project root, add the plugin to your Vite configuration file:

```ts
// vite.config.ts
import sitemap from '@qalisa/vike-plugin-sitemap';

export default {
  plugins: [sitemap({
    baseUrl: 'https://yourwebsite.com' // can be omited in dev
  })]
};
```

## Configuration Options

| Option              | Type      | Default           | Description |
|---------------------|----------|-------------------|-------------|
| `pagesDir`         | `string`  | `'pages'`         | Directory containing your Vike pages. |
| `baseUrl`          | `string`  | `'http://localhost:3000'` | Base URL of your website. |
| `filename`         | `string`  | `'sitemap.xml'`   | Name of the sitemap file. |
| `outputDir`        | `string`  | `'.'`            | Output directory for the sitemap and robots.txt, relative to your output bundle client files. |
| `defaultChangefreq`| `string`  | `'weekly'`        | Default change frequency for pages. |
| `defaultPriority`  | `number`  | `0.5`             | Default priority for pages. |
| `customEntries`    | `SitemapEntry[]` | `[]` | Additional custom sitemap entries. |
| `robots`           | `RobotsOptions` or `false` | `{ userAgent: '*', disallow: { cloudflare: true } }` | Robots.txt options. If you pass `false`, no robots.txt is generated |

## License

MIT License