Merge branch 'main' into templating-mode-selector

Author: paoloricciuti

.github/workflows/docs-preview-create.yml

@@ -39,15 +39,18 @@ jobs:
       - uses: actions/checkout@v4
         with:
           token: ${{ secrets.GH_TOKEN }}
+          ref: main # Explicitly checkout main branch first
       - uses: pnpm/action-setup@v4
       - uses: actions/setup-node@v4
         with:
           node-version: 22
           cache: pnpm
       - run: pnpm install --frozen-lockfile
 
-      - name: Checkout
-        run: git fetch origin ${{ env.BRANCH }} && git checkout ${{ env.BRANCH }} || git checkout -b ${{ env.BRANCH }}
+      - name: Create or reset branch from main
+        run: |
+          git fetch origin
+          git checkout -B ${{ env.BRANCH }} # Force create/reset branch based on current main
 
       - name: Sync
         run: cd apps/svelte.dev && pnpm sync-docs --owner="${{ inputs.owner }}" -p "${{ inputs.repo }}#${{ inputs.branch }}"
@@ -59,7 +62,7 @@ jobs:
 
       - name: Push
         id: push
-        run: git add -A && git commit -m "sync docs" && git push -u origin ${{ env.BRANCH }}
+        run: git add -A && git commit -m "sync docs" && git push -u origin ${{ env.BRANCH }} --force
 
       - name: Request preview comment
         uses: peter-evans/repository-dispatch@v3

apps/svelte.dev/.gitignore

@@ -14,3 +14,5 @@
 
 # TODO remove this after https://github.com/sveltejs/kit/pull/12718 is merged
 /content/docs/kit/50-reference
+.vercel
+.env*.local

apps/svelte.dev/content/blog/2025-05-01-whats-new-in-svelte-may-2025.md

@@ -0,0 +1,74 @@
+---
+title: "What's new in Svelte: May 2025"
+description: 'Svelte Summit soon! Plus, await in components'
+author: Dani Sandoval
+authorURL: https://dreamindani.com
+---
+
+Only a week until [Svelte Summit Spring 2025](https://www.sveltesummit.com/)! If you can't make it in-person to Barcelona, you can purchase a virtual ticket [here](https://www.sveltesummit.com/virtual-ticket).
+
+But before that, we've got a few updates to highlight...
+
+## What's new in Svelte and SvelteKit
+
+The Svelte maintainers have been hard at work building out [Asynchronous Svelte](https://github.com/sveltejs/svelte/discussions/15845) this month, but still found the time to ship some helpful features. If you're interested in trying out the async branch, or just want to follow along with the development, check out [feat: allow await in components #15844](https://github.com/sveltejs/svelte/pull/15844)
+
+- Certain expressions will now be partially evaluated to improve runtime performance (**[email protected]/5.28.0**, [#15494](https://github.com/sveltejs/svelte/pull/15494)/[#15781](https://github.com/sveltejs/svelte/pull/15781))
+- The Svelte CLI (`sv`) has added a `--install <package-manager>` flag to `create` and `add` to specify which package manager to use when running (**[email protected]**, [#531](https://github.com/sveltejs/cli/pull/531))
+- The two separate CloudFlare adapters have been merged into one: `adapter-cloudflare` (**[email protected]**, [#13634](https://github.com/sveltejs/kit/pull/13634))
+- `adapter-vercel` will now create symlink functions for each route, for better observability (**[email protected]**, [#13679](https://github.com/sveltejs/kit/pull/13679))
+
+There were a number of fixes in SvelteKit too - including an improvement to the `HandleServerError` hook to give it access to `getRequestEvent`! ([#13666](https://github.com/sveltejs/kit/pull/13666))
+
+For a full list of bug fixes in Svelte, SvelteKit and its adapters, check out their CHANGELOGs [here](https://github.com/sveltejs/svelte/blob/main/packages/svelte/CHANGELOG.md) and [here](https://github.com/sveltejs/kit/tree/main/packages). Interested in all the new fixes in language tools? You can find them [here](https://github.com/sveltejs/language-tools/releases).
+
+---
+
+## Community Showcase
+
+### Apps & Sites built with Svelte
+
+- [TableSlayer](https://github.com/siege-perilous/tableslayer) is an open source software for managing in person RPG games with digital displays (check out the video demo on [Reddit](https://www.reddit.com/r/sveltejs/comments/1jnco5h/built_with_svelte_my_open_source_software_for/))
+- [Iconia](https://iconia.dev/) is a free tool that understands natural language and responds with relevant icons from famous icon libraries
+- [CMSDocs](https://cmsdocs.com/) transforms your Google Docs into Blog CMS
+- [Svelte Changelog v2](https://svelte-changelog.dev/) is out now and is a reimagined way of staying up to date on all the new changes in the Svelte ecosystem
+- [Hookah UI](https://github.com/AdamShannag/hookah-ui) is a visual configuration builder for the Hookah project
+- [mockiapi](https://github.com/sfeSantos/mockiapi) is a mock API server that allows you to define endpoints, return custom JSON responses, and simulate real-world API behavior
+- [soarSQL](https://soarsql.com/) is an SQL editor made for analytical processing on Postgres, MySQL, and CSVs - powered by duckDB
+- [Persona Simulator](https://personasim.fow.sh/) helps you practice your communication skills by chatting with different personas
+- [Typo](https://typo.robino.dev/) is a web-based markdown editor with formatting in codeblocks and typescript execution
+- [FernOS](https://github.com/mrtechtroid/fernos) is a lightweight operating system running inside your browser
+
+### Learning Resources
+
+_Featuring Svelte Contributors and Ambassadors_
+
+- [SvelteKit is the best way to build single page apps - and it just got even better!](https://www.youtube.com/watch?v=vCMTxL1jWbw) by Stanislav Khromov (Video)
+- [Svelte London - April 2025](https://www.youtube.com/watch?v=7m6HExTKAqM)
+  - Building cross-platform browser extensions with Svelte by Oliver Turner ([10:52](https://www.youtube.com/live/7m6HExTKAqM?si=tWUKbSm2IuhO0N_r&t=652))
+  - Kioko: Coding CAD by Armel de Montgros and Soloman Azizi ([43:00](https://www.youtube.com/live/7m6HExTKAqM?si=EOmS3Hy-AwIgrBTU&t=2613))
+
+_This Week in Svelte_
+
+- [Ep. 100](https://www.youtube.com/watch?v=BGNykPO4L7c) — Q&A with Rich Harris
+- [Ep. 101](https://www.youtube.com/watch?v=yp4330KsYcU) — Changelog
+
+_To Read_
+
+- Graphite - an open source 2D procedural graphics editor built with Svelte - has released a [product update blog post](https://graphite.rs/blog/graphite-progress-report-q4-2024/)
+- [Cloudflare Workers & SvelteKit: BetterAuth, Custom Domain, Google OAuth, OTP & Email - Securing Your Application](https://jilles.me/cloudflare-workers-sveltekit-betterauth-custom-domain-google-oauth-otp-email-securing-your-application/) by Jilles Soeters
+- [Building a Real-time Dashboard with Flask and Svelte](https://testdriven.io/blog/flask-svelte/) by Amir Tadrisi
+- [Copying Nuxt's useState in Qwik and Svelte](https://dev.to/jdgamble555/copying-nuxts-usestate-in-qwik-and-svelte-5eo3) by Jonathan Gamble
+
+### Libraries, Tools & Components
+
+- [diaper](https://github.com/devantic/diaper) is an advanced bottom sheet component for Svelte 5
+- [mcp-svelte-docs](https://github.com/spences10/mcp-svelte-docs) is an MCP server that lets you search and access Svelte documentation with built-in caching
+- [Version 4 of Anime.js](https://animejs.com/) - a popular JS animation library - has been released
+- [DeepWiki](https://deepwiki.com/sveltejs/svelte) has created a comprehensive introduction to the Svelte framework repository
+- [Vite Static Assets Plugin](https://www.npmjs.com/package/vite-static-assets-plugin) is a Vite plugin that automatically scans your static assets directory, generates a type-safe TypeScript module with all asset paths to help during build or development time
+- [Mode Watcher v1](https://github.com/svecosystem/mode-watcher) provides simple light/dark mode management, now rewritten with first-class Svelte 5 support
+
+That's it for this month! Let us know if we missed anything on [Reddit](https://www.reddit.com/r/sveltejs/) or [Discord](https://discord.gg/svelte).
+
+Until next time 👋🏼!

apps/svelte.dev/content/docs/cli/20-commands/10-sv-create.md

@@ -36,9 +36,19 @@ Prevent typechecking from being added. Not recommended!
 
 Run the command without the interactive add-ons prompt
 
+### `--install <package-manager>`
+
+Installs dependencies with a specified package manager:
+
+- `npm`
+- `pnpm`
+- `yarn`
+- `bun`
+- `deno`
+
 ### `--no-install`
 
-Skip dependency installation
+Prevents installing dependencies.
 
 <!-- ## Programmatic interface
 

apps/svelte.dev/content/docs/cli/20-commands/20-sv-add.md

@@ -21,20 +21,21 @@ You can select multiple space-separated add-ons from [the list below](#Official-
 
 - `-C`, `--cwd` — path to the root of your Svelte(Kit) project
 - `--no-preconditions` — skip checking preconditions <!-- TODO what does this mean? -->
-- `--no-install` — skip dependency installation
+- `--install` — installs dependencies with a specified package manager
+- `--no-install` — prevents installing dependencies
 
 ## Official add-ons
 
-<!-- TODO this should be a separate section, each of these should have their own page -->
-
-- `drizzle`
-- `eslint`
-- `sveltekit-adapter`
-- `lucia`
-- `mdsvex`
-- `paraglide`
-- `playwright`
-- `prettier`
-- `storybook`
-- `tailwindcss`
-- `vitest`
+<!-- TODO: it'd be nice for this to live on the "add-ons" page, but we first need svelte.dev to support making pages from headings -->
+
+- [`drizzle`](drizzle)
+- [`eslint`](eslint)
+- [`lucia`](lucia)
+- [`mdsvex`](mdsvex)
+- [`paraglide`](paraglide)
+- [`playwright`](playwright)
+- [`prettier`](prettier)
+- [`storybook`](storybook)
+- [`sveltekit-adapter`](sveltekit-adapter)
+- [`tailwindcss`](tailwind)
+- [`vitest`](vitest)

apps/svelte.dev/content/docs/cli/30-add-ons/05-drizzle.md

@@ -0,0 +1,58 @@
+---
+NOTE: do not edit this file, it is generated in apps/svelte.dev/scripts/sync-docs/index.ts
+title: drizzle
+---
+
+[Drizzle ORM](https://orm.drizzle.team/) is a TypeScript ORM offering both relational and SQL-like query APIs, and which is serverless-ready by design.
+
+## Usage
+
+```bash
+npx sv add drizzle
+```
+
+## What you get
+
+- a setup that keeps your database access in SvelteKit's server files
+- an `.env` file to store your credentials
+- compatibility with the Lucia auth add-on
+- an optional Docker configuration to help with running a local database
+
+## Options
+
+### database
+
+Which database variant to use:
+
+- `postgresql` — the most popular open source database
+- `mysql` — another popular open source database
+- `sqlite` — file-based database not requiring a database server
+
+```bash
+npx sv add --drizzle=postgresql
+```
+
+### client
+
+The SQL client to use, depends on `database`:
+
+- For `postgresql`: `postgres.js`, `neon`,
+- For `mysql`: `mysql2`, `planetscale`
+- For `sqlite`: `better-sqlite3`, `libsql`, `turso`
+
+```bash
+npx sv add --drizzle=postgresql,postgres.js
+```
+
+Drizzle is compatible with well over a dozen database drivers. We just offer a few of the most common ones here for simplicity, but if you'd like to use another one you can choose one as a placeholder and swap it out for another after setup by choosing from [Drizzle's full list of compatible drivers](https://orm.drizzle.team/docs/connect-overview#next-steps).
+
+### docker
+
+Whether to add Docker Compose configuration. Only available for [`database`](#Options-database) `postgresql` or `mysql`
+
+- `docker` - generates `docker-compose.yml`
+- `no-docker` - does not generate docker config
+
+```bash
+npx sv add --drizzle=postgresql,postgres.js,docker
+```

apps/svelte.dev/content/docs/cli/30-add-ons/10-eslint.md

@@ -0,0 +1,19 @@
+---
+NOTE: do not edit this file, it is generated in apps/svelte.dev/scripts/sync-docs/index.ts
+title: eslint
+---
+
+[ESLint](https://eslint.org/) finds and fixes problems in your code.
+
+## Usage
+
+```bash
+npx sv add eslint
+```
+
+## What you get
+
+- the relevant packages installed including `eslint-plugin-svelte`
+- an `eslint.config.js` file
+- updated `.vscode/settings.json`
+- configured to work with TypeScript and `prettier` if you're using those packages

apps/svelte.dev/content/docs/cli/30-add-ons/15-lucia.md

@@ -0,0 +1,27 @@
+---
+NOTE: do not edit this file, it is generated in apps/svelte.dev/scripts/sync-docs/index.ts
+title: lucia
+---
+
+An auth setup following [the Lucia auth guide](https://lucia-auth.com/).
+
+## Usage
+
+```bash
+npx sv add lucia
+```
+
+## What you get
+
+- an auth setup for SvelteKit and Drizzle following the best practices from the Lucia auth guide
+- optional demo registration and login pages
+
+## Options
+
+### demo
+
+Whether to include demo registration and login pages.
+
+```bash
+npx sv add --lucia=demo
+```

apps/svelte.dev/content/docs/cli/30-add-ons/20-mdsvex.md

@@ -0,0 +1,16 @@
+---
+NOTE: do not edit this file, it is generated in apps/svelte.dev/scripts/sync-docs/index.ts
+title: mdsvex
+---
+
+[mdsvex](https://mdsvex.pngwn.io) is a markdown preprocessor for Svelte components - basically MDX for Svelte. It allows you to use Svelte components in your markdown, or markdown in your Svelte components.
+
+## Usage
+
+```bash
+npx sv add mdsvex
+```
+
+## What you get
+
+- mdsvex installed and configured in your `svelte.config.js`

apps/svelte.dev/content/docs/cli/30-add-ons/25-paraglide.md

@@ -0,0 +1,39 @@
+---
+NOTE: do not edit this file, it is generated in apps/svelte.dev/scripts/sync-docs/index.ts
+title: paraglide
+---
+
+[Paraglide from Inlang](https://inlang.com/m/gerre34r/library-inlang-paraglideJs) is a compiler-based i18n library that emits tree-shakable message functions with small bundle sizes, no async waterfalls, full type-safety, and more.
+
+## Usage
+
+```bash
+npx sv add paraglide
+```
+
+## What you get
+
+- Inlang project settings
+- paraglide Vite plugin
+- SvelteKit `reroute` and `handle` hooks
+- `text-direction` and `lang` attributes in `app.html`
+- updated `.gitignore`
+- an optional demo page showing how to use paraglide
+
+## Options
+
+### availableLanguageTags
+
+The languages you'd like to support specified as IETF BCP 47 language tags.
+
+```bash
+npx sv add --paraglide=en,es
+```
+
+### demo
+
+Whether to generate an optional demo page showing how to use paraglide.
+
+```bash
+npx sv add --paraglide=demo
+```

apps/svelte.dev/content/docs/cli/30-add-ons/30-playwright.md

@@ -0,0 +1,19 @@
+---
+NOTE: do not edit this file, it is generated in apps/svelte.dev/scripts/sync-docs/index.ts
+title: playwright
+---
+
+[Playwright](https://playwright.dev) browser testing.
+
+## Usage
+
+```bash
+npx sv add playwright
+```
+
+## What you get
+
+- scripts added in your `package.json`
+- a Playwright config file
+- an updated `.gitignore`
+- a demo test

apps/svelte.dev/content/docs/cli/30-add-ons/35-prettier.md

@@ -0,0 +1,18 @@
+---
+NOTE: do not edit this file, it is generated in apps/svelte.dev/scripts/sync-docs/index.ts
+title: prettier
+---
+
+[Prettier](https://prettier.io) is an opinionated code formatter.
+
+## Usage
+
+```bash
+npx sv add prettier
+```
+
+## What you get
+
+- scripts in your `package.json`
+- `.prettierignore` and `.prettierrc` files
+- updates to your eslint config if you're using that package

apps/svelte.dev/content/docs/cli/30-add-ons/40-storybook.md

@@ -0,0 +1,17 @@
+---
+NOTE: do not edit this file, it is generated in apps/svelte.dev/scripts/sync-docs/index.ts
+title: storybook
+---
+
+[Storybook](https://storybook.js.org/) is a frontend component workshop.
+
+## Usage
+
+```bash
+npx sv add storybook
+```
+
+## What you get
+
+- `npx storybook init` run for you from the same convenient `sv` CLI used for all other add-ons
+- [Storybook for SvelteKit](https://storybook.js.org/docs/get-started/frameworks/sveltekit) or [Storybook for Svelte & Vite](https://storybook.js.org/docs/get-started/frameworks/svelte-vite) with default config provided, easy mocking of many SvelteKit modules, automatic link handling, and more.