Leptos template Build Guide for Windows user

[gembleman]

Issue Description

When using Leptos with Cloudflare Workers in a Windows PowerShell environment, you might encounter build issues with the following command:

Running custom build: cargo leptos build --release && LEPTOS_OUTPUT_NAME=start-axum worker-build --release --features ssr

This command uses Linux/Unix-style environment variable settings, which doesn't work properly in Windows PowerShell.

Solution

We can resolve this by managing the build process with a PowerShell script.

1. Create PowerShell Build Script

Create a build.ps1 file in your project root with the following content:

# build.ps1
& {
    $env:LEPTOS_OUTPUT_NAME = "leptos_worker"
    cargo leptos build --release
    worker-build --release --features ssr
}

2. Modify wrangler.toml

Update your wrangler.toml file as follows:

name = "leptos-worker"
main = "build/worker/shim.mjs"
compatibility_date = "2024-09-01"

[build]
command = "pwsh -File build.ps1"

[assets]
directory = "./public"

and... build

> npx wrangler dev