sv

Everything you need to build a Svelte project, powered by sv.

Creating a project

If you're seeing this, you've probably already done this step. Congrats!

# create a new project
npx sv create my-app

To recreate this project with the same configuration:

# recreate this project
pnpm dlx sv@0.15.2 create --template minimal --types ts --add prettier playwright tailwindcss="plugins:typography,forms" vitest="usages:unit,component" eslint sveltekit-adapter="adapter:cloudflare+cfTarget:workers" --install pnpm ./

Developing

Install dependencies and build the workspace processing package once before starting development:

pnpm install
pnpm package:build
pnpm dev

Rebuild the package after changing its wrapper or Rust implementation. See the package build prerequisites.

The scalar Wasm package processes all images. This path accepts integer crops and reports unsupported fractional crops through the existing error display. It filters the packed cropped image, so filter edges clamp to that crop.

After building the package, run its website integration fixtures with:

pnpm exec vitest run --project client src/lib/processing/package-pipeline.browser.spec.ts

Building

To create a production version of your app:

pnpm build

The website build first builds the public workspace package. Standalone historical benchmark tools retain their own staged scalar artifacts.

You can preview the production build with npm run preview.

To deploy your app, you may need to install an adapter for your target environment.

Threaded Wasm build prerequisites

pnpm wasm:build:threads requires nightly-2024-08-02, its wasm32-unknown-unknown target, and rust-src. The root rust-toolchain.toml configures stable Rust; it does not provision this separate nightly. Install these prerequisites once before running the threaded build:

rustup toolchain install nightly-2024-08-02 --profile minimal --component rust-src --target wasm32-unknown-unknown

rust-src is required by the threaded build's -Z build-std=panic_abort,std.