svelte-adapter-ghpages

SvelteKit adapter for gh-pages

⚠️ WARNING: this project is considered to be in BETA until SvelteKit is available for general use and the Adapter API is stable!

📛 Features

This is an adapter for the SvelteKit. This adapter will generate 404.html in addition to the files generated by @sveltejs/adapter-static to work well with GitHub Pages.

💿 Installation

npm install --save-dev svelte-adapter-ghpages

📖 Usage

Add it to svelte.config.js

// svelte.config.js
import adapterGhpages from "svelte-adapter-ghpages";

/** @type {import('@sveltejs/kit').Config} */
const config = {
  // ...
  kit: {
    // ...
    paths: {
      base: "/your-repo-name",
    },
    // ...
    adapter: adapterGhpages(
      // default options are shown
      pages: 'build',
      assets: 'build',
      fallback: null
    ),
    // ...
  },
};

Add 404.svelte to the routes directory.

For example: src/routes/404.svelte

<h1>404</h1>
<blockquote>
  <p>Not Found</p>
</blockquote>

404.svelte will be placed as 404.html when you run npm run build.

Options

pages, assets, fallback

See https://github.com/sveltejs/kit/tree/master/packages/adapter-static#pages.

🍻 Contributing

Welcome contributing!

Please use GitHub's Issues/PRs.

🔒 License

See the LICENSE file for license rights and limitations (MIT).