Nana Plays Minesweeper

    @sveltejs/adapter-cloudflare
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.0-next.21 • Public • Published

    adapter-cloudflare

    Adapter for building SvelteKit applications on Cloudflare Pages with Workers integration.

    If you're using adapter-auto, you don't need to install this — it's already included.

    Comparisons

    • adapter-cloudflare – supports all SvelteKit features; builds for Cloudflare Pages
    • adapter-cloudflare-workers – supports all SvelteKit features; builds for Cloudflare Workers
    • adapter-static – only produces client-side static assets; compatible with Cloudflare Pages

    Note: Cloudflare Pages' new Workers integration is currently in beta.
    Compared to adapter-cloudflare-workers, this adapter will be the preferred approach for most users since building on top of Pages unlocks automatic builds and deploys, preview deployments, instant rollbacks, etc.
    From SvelteKit's perspective, there is no difference and no functionality loss when migrating to/from the Workers and the Pages adapters.

    Installation

    $ npm i --save-dev @sveltejs/adapter-cloudflare

    Usage

    You can include these changes in your svelte.config.js configuration file:

    import adapter from '@sveltejs/adapter-cloudflare';
    
    export default {
      kit: {
        adapter: adapter()
      }
    };

    Deployment

    Please follow the Get Started Guide for Cloudflare Pages to begin.

    When configuring your project settings, you must use the following settings:

    • Framework preset – None
    • Build commandnpm run build or svelte-kit build
    • Build output directory.svelte-kit/cloudflare
    • Environment variables
      • NODE_VERSION: 16 or 14

    Important: You need to add a NODE_VERSION environment variable to both the "production" and "preview" environments. You can add this during project setup or later in the Pages project settings. SvelteKit requires Node 14.13 or later, so you should use 14 or 16 as the NODE_VERSION value.

    Environment variables

    The env object, containing KV namespaces etc, is passed to SvelteKit via the platform property along with context, meaning you can access it in hooks and endpoints:

    // src/app.d.ts
    declare namespace App {
    	interface Locals {}
    
    +	interface Platform {
    +		env: {
    +			COUNTER: DurableObjectNamespace;
    +		};
    +		context: {
    +			waitUntil(promise: Promise<any>): void;
    +		}
    +	}
    
    	interface Session {}
    
    	interface Stuff {}
    }
    export async function post({ request, platform }) {
      const counter = platform.env.COUNTER.idFromName('A');
    }

    platform.env is only available in the production build. Use wrangler to test it locally

    Notes

    Functions contained in the /functions directory at the project's root will not be included in the deployment, which is compiled to a single _worker.js file. Functions should be implemented as endpoints in your SvelteKit app.

    Changelog

    The Changelog for this package is available on GitHub.

    Keywords

    none

    Install

    npm i @sveltejs/adapter-cloudflare

    DownloadsWeekly Downloads

    30,081

    Version

    1.0.0-next.21

    License

    MIT

    Unpacked Size

    10 kB

    Total Files

    6

    Last publish

    Collaborators

    • rich_harris
    • svelte-admin
    • conduitry
    • dominik_g