Add Svelte frontends and installer packaging

Author: TDanks2000

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+- Adds `--frontend svelte` and `--frontend sveltekit` renderer modes with prompts, CLI help, manifest/schema support, generated templates, and validation coverage.
+- Adds `--packaging installers` for generated AppImage, deb, DMG collection, and NSIS packaging helpers around Electrobun release artifacts.
+
 ## 1.1.0
 
 ### Added

README.md

@@ -5,7 +5,7 @@
 [![Node version](https://img.shields.io/node/v/create-electrobun-stack.svg)](https://www.npmjs.com/package/create-electrobun-stack)
 [![Bun >=1.3.0](https://img.shields.io/badge/Bun-%3E%3D1.3.0-000?logo=bun&logoColor=white)](https://bun.sh)
 
-Scaffold a production-minded Electrobun desktop app with Bun, React or Preact, TypeScript, Vite, Biome, typed Electrobun RPC, and a small set of optional integrations that can be enabled at create time or added later.
+Scaffold a production-minded Electrobun desktop app with Bun, React, Preact, Svelte, or SvelteKit, TypeScript, Vite, Biome, typed Electrobun RPC, optional native utilities, and optional installer packaging helpers that can be enabled at create time or added later.
 
 The generator is intentionally explicit: every selected stack option is written to `ces.json`, the generated project README explains what was scaffolded, and the `add` command can use that manifest to enable missing features without asking you to remember the original command.
 
@@ -70,6 +70,7 @@ bunx create-electrobun-stack my-app \
   --db-setup none \
   --settings none \
   --package-manager bun \
+  --packaging none \
   --testing bun \
   --addons none \
   --examples rpc \
@@ -116,6 +117,22 @@ bunx create-electrobun-stack my-app \
   --router none
 ```
 
+Create a Svelte renderer:
+
+```bash
+bunx create-electrobun-stack my-app \
+  --frontend svelte \
+  --router none
+```
+
+Create a static SvelteKit renderer:
+
+```bash
+bunx create-electrobun-stack my-app \
+  --frontend sveltekit \
+  --router none
+```
+
 Create with JSON-file persistence and desktop smoke tests:
 
 ```bash
@@ -131,6 +148,12 @@ Add file dialogs and clipboard utilities:
 bunx create-electrobun-stack my-app --native-utils desktop-kit
 ```
 
+Add AppImage, deb, DMG, and NSIS packaging helpers:
+
+```bash
+bunx create-electrobun-stack my-app --packaging installers
+```
+
 Start small and add a feature later:
 
 ```bash
@@ -153,7 +176,7 @@ bun run format
 bun test
 ```
 
-Some options add commands. For example, `--addons turborepo` adds `bun run check`, and `--orm drizzle` adds Drizzle scripts.
+Some options add commands. For example, `--addons turborepo` adds `bun run check`, `--orm drizzle` adds Drizzle scripts, and `--packaging installers` adds `bun run package:release` plus platform-specific packaging commands.
 
 ## Docs
 

docs/ces.schema.json

@@ -53,7 +53,7 @@
     },
     "frontend": {
       "items": {
-        "enum": ["react", "preact"]
+        "enum": ["react", "preact", "svelte", "sveltekit"]
       },
       "type": "array"
     },
@@ -75,6 +75,9 @@
     "packageName": {
       "type": "string"
     },
+    "packaging": {
+      "enum": ["none", "installers"]
+    },
     "projectName": {
       "type": "string"
     },
@@ -140,6 +143,7 @@
     "examples",
     "auth",
     "packageManager",
+    "packaging",
     "dbSetup",
     "api",
     "navigation",

docs/guides/add-command.md

@@ -56,6 +56,7 @@ Supported additive changes include:
 - `--query none` to `--query tanstack-query`
 - `--router none` to `--router tanstack-router` or `--router react-router`
 - `--addons none` to `--addons turborepo`
+- `--packaging none` to `--packaging installers`
 
 The command does not remove features. It also does not change `frontend`, `runtime`, `packageManager`, `buildEnv`, or `buildTargets`.
 
@@ -107,6 +108,12 @@ Add the native file dialog RPC utility:
 bunx create-electrobun-stack add --native-utils file-dialogs
 ```
 
+Add installer packaging helpers:
+
+```bash
+bunx create-electrobun-stack add --packaging installers
+```
+
 ## Conflict Behavior
 
 The add command protects existing generated projects from destructive stack changes. These are rejected:

docs/guides/generated-project.md

@@ -15,6 +15,8 @@ my-app/
   vite.config.ts
   biome.json
   tsconfig.json
+  scripts/
+    package-electrobun.ts
   tests/
     manifest.test.ts
     desktop-smoke.test.ts
@@ -49,7 +51,7 @@ my-app/
           app.css
 ```
 
-That layout matches the default stack with the optional desktop smoke test shown for reference. The default stack is TanStack Router, Electrobun RPC, app menu, local navigation rules, Tailwind CSS, and Bun tests. Options can add files such as `src/bun/db/client.ts`, `src/bun/settings/store.ts`, `tests/desktop-smoke.test.ts`, `components.json`, and `turbo.json`, or omit default files when you choose alternatives like `--router none`, `--app-menu none`, or `--testing none`.
+That layout matches the default stack with optional desktop smoke and installer packaging files shown for reference. The default stack is TanStack Router, Electrobun RPC, app menu, local navigation rules, Tailwind CSS, and Bun tests. Options can add files such as `src/bun/db/client.ts`, `src/bun/settings/store.ts`, `tests/desktop-smoke.test.ts`, `scripts/package-electrobun.ts`, `components.json`, and `turbo.json`, or omit default files when you choose alternatives like `--router none`, `--app-menu none`, `--packaging none`, or `--testing none`.
 
 ## Runtime Model
 
@@ -110,13 +112,15 @@ Add RPC contract types in `src/shared/rpc/schema.ts`, handler implementation in
 
 With `--frontend react`, all router choices are available.
 
-With `--frontend preact`, use `--router none`; the generated Preact renderer mounts `Home` directly.
+With `--frontend preact` or `--frontend svelte`, use `--router none`; the generated renderer mounts `Home` directly.
+
+With `--frontend sveltekit`, use `--router none`; the generated SvelteKit app uses SvelteKit file routing under `src/views/main/routes`.
 
 With `--router tanstack-router`, edit files under `src/views/main/routes`. The generated route tree is produced by the TanStack Router Vite plugin.
 
 With `--router react-router`, edit routes in `src/views/main/app.tsx`.
 
-With `--router none`, the app renders `Home` directly from `src/views/main/app.tsx`.
+With `--router none`, React and Preact apps render `Home` directly from `src/views/main/app.tsx`; Svelte apps render `Home` from `src/views/main/App.svelte`.
 
 ### RPC
 
@@ -158,6 +162,21 @@ With `--native-utils desktop-kit`, both native utility examples are enabled.
 
 With `--testing desktop-smoke`, `tests/desktop-smoke.test.ts` mocks `electrobun/bun`, imports the generated window code, creates the main window, and verifies launch options without opening a real OS window.
 
+### Installer Packaging
+
+With `--packaging installers`, `scripts/package-electrobun.ts` wraps Electrobun's release artifacts with extra distribution formats. It copies Electrobun artifacts, reuses Electrobun's generated DMG on macOS, builds AppImage and deb packages on Linux, and builds an NSIS wrapper around Electrobun's Windows setup executable on Windows.
+
+The generated packaging commands are:
+
+```bash
+bun run package:release
+bun run package:linux
+bun run package:mac
+bun run package:windows
+```
+
+These commands expect non-dev Electrobun artifacts. Use `package:release` for a stable build, or run `bun run build` with a canary/stable build channel before a platform-specific packaging command. Linux AppImage packaging requires `appimagetool`, Linux deb packaging requires `dpkg-deb`, and Windows packaging requires `makensis`.
+
 ## Manifest
 
 `ces.json` is part of the project contract. Keep it in source control.
@@ -182,6 +201,7 @@ Before distributing an app generated by this stack:
 - Choose build targets intentionally.
 - Run `bun run typecheck`, `bun run lint`, and `bun test` when present.
 - Run `bun run build` on the platform you are packaging for.
+- If `--packaging installers` is enabled, run the package command on the matching OS runner and inspect `dist/installers`.
 - Review local persistence paths and database behavior for your release model.
 
 ## Troubleshooting

docs/internals/templates.md

@@ -64,7 +64,7 @@ templates/minimal/
 `base` is always rendered. It contains the common Electrobun app:
 
 - Bun entrypoint and window creation.
-- React or Preact renderer entrypoint.
+- Shared renderer styles and framework-neutral renderer support files.
 - Shared constants and types.
 - Optional RPC, router, query, settings, and styling branches controlled by Handlebars data.
 - Generated README tailored to selected stack flags.
@@ -82,6 +82,22 @@ Adds `turbo.json` and enables Turbo scripts/dependency through the base `package
 
 Adds `src/bun/menu.ts`. The base Bun entrypoint calls it when `--app-menu edit` is selected.
 
+### `frontend/jsx`
+
+Adds the React/Preact Vite renderer entrypoint, `App`, `Home`, and `index.html`.
+
+### `frontend/svelte-common`
+
+Adds the shared Svelte `Home.svelte` renderer used by both Svelte frontend modes.
+
+### `frontend/svelte`
+
+Adds the direct Svelte Vite entrypoint, `App.svelte`, and `index.html`.
+
+### `frontend/sveltekit`
+
+Adds SvelteKit static adapter config and routes under `src/views/main/routes`.
+
 ### `database/sqlite`
 
 Adds a Bun SQLite client and database status surface.
@@ -114,6 +130,10 @@ Adds Tailwind-specific style overlays.
 
 Plain CSS is handled by the base style templates.
 
+### `packaging/installers`
+
+Adds `scripts/package-electrobun.ts`. The base package, TypeScript, and README templates add packaging commands and references when `--packaging installers` is selected.
+
 ### `testing/bun`
 
 Adds `tests/manifest.test.ts`. The base package and TypeScript templates add the script and include path when testing is enabled.
@@ -137,6 +157,9 @@ Template data is built in `src/scaffold.ts`. Important booleans include:
 - `hasTanstackQuery`
 - `hasPreactFrontend`
 - `hasReactFrontend`
+- `hasSvelteFrontend`
+- `hasSvelteKitFrontend`
+- `hasSvelteFamilyFrontend`
 - `hasTailwind`
 - `hasShadcn`
 - `hasDatabase`
@@ -147,6 +170,7 @@ Template data is built in `src/scaffold.ts`. Important booleans include:
 - `hasDatabaseSettings`
 - `hasNativeClipboard`
 - `hasNativeFileDialogs`
+- `hasInstallerPackaging`
 - `hasDesktopSmokeTest`
 - `hasAppMenu`
 - `hasNavigationGuard`

docs/llm.txt

@@ -1,7 +1,7 @@
 create-electrobun-stack LLM guide
 
 Purpose:
-Scaffold an Electrobun desktop app with Bun, React or Preact, TypeScript, Vite, Biome, typed Electrobun RPC, and optional integrations. The generated project includes ces.json so future tooling can understand and expand the stack.
+Scaffold an Electrobun desktop app with Bun, React, Preact, Svelte, or SvelteKit, TypeScript, Vite, Biome, typed Electrobun RPC, and optional integrations. The generated project includes ces.json so future tooling can understand and expand the stack.
 
 Primary commands:
 
@@ -42,6 +42,7 @@ Default stack:
 --db-setup none
 --settings none
 --package-manager bun
+--packaging none
 --testing bun
 --addons none
 --examples rpc
@@ -50,7 +51,7 @@ Default stack:
 
 Generated app:
 - Bun native process in src/bun.
-- React or Preact renderer in src/views/main.
+- React, Preact, Svelte, or SvelteKit renderer in src/views/main.
 - Shared types in src/shared.
 - Typed RPC contract in src/shared/rpc/schema.ts when --api electrobun-rpc is selected.
 - ces.json manifest at project root.
@@ -72,6 +73,8 @@ Option behavior:
 - --router react-router adds React Router with HashRouter.
 - --router none renders Home directly.
 - --frontend preact adds a Preact renderer with @preact/preset-vite. It currently requires --router none, --query none, and --ui none.
+- --frontend svelte adds a direct Svelte renderer with @sveltejs/vite-plugin-svelte. It currently requires --router none, --query none, and --ui none.
+- --frontend sveltekit adds a static SvelteKit renderer with @sveltejs/adapter-static and SvelteKit file routing. It currently requires --router none, --query none, and --ui none.
 - --query tanstack-query adds @tanstack/react-query and QueryClientProvider.
 - --styling tailwindcss adds Tailwind CSS v4 and @tailwindcss/vite.
 - --styling css omits Tailwind dependencies.
@@ -94,6 +97,7 @@ Option behavior:
 - --settings json adds data/settings.json persistence and requires Electrobun RPC.
 - --settings database stores settings in SQLite and requires Electrobun RPC plus SQLite.
 - --package-manager bun|npm|pnpm|yarn controls install/run command text and package manager metadata.
+- --packaging installers adds scripts/package-electrobun.ts plus package:release, package:linux, package:mac, and package:windows scripts for AppImage, deb, DMG collection, and NSIS wrapping around Electrobun artifacts.
 - --testing bun adds bun test and tests/manifest.test.ts.
 - --testing desktop-smoke adds bun test, tests/manifest.test.ts, and tests/desktop-smoke.test.ts with mocked Electrobun launch verification.
 - --testing none omits tests.
@@ -107,7 +111,7 @@ Invalid combinations:
 - Native utility examples require Electrobun RPC.
 - RPC examples require Electrobun RPC.
 - shadcn requires Tailwind CSS.
-- Preact requires --router none, --query none, and --ui none.
+- Non-React frontends require --router none, --query none, and --ui none.
 
 Add command:
 - Reads ces.json from cwd or --cwd.
@@ -126,7 +130,7 @@ Add command:
 - Does not remove features or switch package managers/build settings.
 
 Manifest:
-- ces.json includes $schema, version, createdAt, reproducibleCommand, projectName, packageName, appIdentifier, template, stack fields, addons, examples, git, install, and features.
+- ces.json includes $schema, version, createdAt, reproducibleCommand, projectName, packageName, appIdentifier, template, stack fields, packaging, addons, examples, git, install, and features.
 - V1 manifests are additive. Unknown fields should be tolerated. Breaking manifest migrations require a documented migration path.
 - Keep ces.json in source control.
 - Prefer create-electrobun-stack add over hand-editing ces.json.

docs/reference/cli.md

@@ -82,7 +82,7 @@ The command reads `ces.json`, applies only the flags you pass, infers required p
 | Option | Values | Default |
 | --- | --- | --- |
 | `--template` | `minimal`, `standard`, `full` | `minimal` |
-| `--frontend` | `react`, `preact` | `react` |
+| `--frontend` | `react`, `preact`, `svelte`, `sveltekit` | `react` |
 | `--router` | `tanstack-router`, `react-router`, `none` | `tanstack-router` |
 | `--query` | `none`, `tanstack-query` | `none` |
 | `--runtime` | `bun` | `bun` |
@@ -94,6 +94,7 @@ The command reads `ces.json`, applies only the flags you pass, infers required p
 | `--db-setup` | `none`, `seed` | `none` |
 | `--settings` | `none`, `json`, `database` | `none` |
 | `--package-manager` | `bun`, `npm`, `pnpm`, `yarn` | `bun` |
+| `--packaging` | `none`, `installers` | `none` |
 | `--testing` | `bun`, `desktop-smoke`, `none` | `bun` |
 | `--addons` | `none`, `turborepo` | `none` |
 | `--examples` | `rpc`, `none` | `rpc` |
@@ -121,8 +122,8 @@ The CLI fails before files are written when unsupported combinations are selecte
 - `--native-utils file-dialogs` requires `--api electrobun-rpc`.
 - `--native-utils clipboard` and `--native-utils desktop-kit` require `--api electrobun-rpc`.
 - `--examples rpc` requires `--api electrobun-rpc`.
-- `--ui shadcn` requires `--styling tailwindcss`.
-- `--frontend preact` currently requires `--router none`, `--query none`, and `--ui none`.
+- `--ui shadcn` requires `--styling tailwindcss` and `--frontend react`.
+- `--frontend preact`, `--frontend svelte`, and `--frontend sveltekit` currently require `--router none`, `--query none`, and `--ui none`.
 
 The `add` command can infer some prerequisites. For example, `add --orm drizzle` enables SQLite if it was missing, and `add --ui shadcn` enables Tailwind CSS if the app was created with plain CSS.
 
@@ -174,6 +175,22 @@ bunx create-electrobun-stack my-app \
   --router none
 ```
 
+Use Svelte with direct rendering:
+
+```bash
+bunx create-electrobun-stack my-app \
+  --frontend svelte \
+  --router none
+```
+
+Use SvelteKit with static file routing:
+
+```bash
+bunx create-electrobun-stack my-app \
+  --frontend sveltekit \
+  --router none
+```
+
 Use plain CSS and no renderer router:
 
 ```bash
@@ -224,6 +241,12 @@ Use native clipboard plus file dialogs:
 bunx create-electrobun-stack my-app --native-utils desktop-kit
 ```
 
+Add installer packaging helpers:
+
+```bash
+bunx create-electrobun-stack my-app --packaging installers
+```
+
 Add desktop launch smoke tests:
 
 ```bash
@@ -272,5 +295,6 @@ Options may add commands:
 
 - `--addons turborepo` adds `bun run check`.
 - `--orm drizzle` adds `bun run db:generate` and `bun run db:studio`.
+- `--packaging installers` adds `bun run package:release`, `bun run package:linux`, `bun run package:mac`, and `bun run package:windows`.
 - `--testing desktop-smoke` keeps `bun test` and adds `tests/desktop-smoke.test.ts`.
 - `--testing none` omits `bun test`.