Svelar

Laravel-inspired framework on top of SvelteKit 2. Brings the developer experience of Laravel — routing, middleware, Eloquent-style ORM, service container, auth, sessions, caching, queues, mail, broadcasting, and more — into the SvelteKit ecosystem.

Batteries included. Authentication, dashboard, admin panel, email templates, API keys, team management, file uploads, and more — all out of the box so you can focus on building your core business features.

Documentation

Full documentation is available at svelar.dev.

Quick Start

# Scaffold a new project (installs deps, shadcn-svelte, runs migrations automatically)
npx @beeblock/svelar new my-app
cd my-app
npm run dev

The short npx @beeblock/svelar runs the CLI from the published core package. Generated apps install @beeblock/svelar, so project-local commands can use npx svelar ....

Or add to an existing SvelteKit project:

npm install @beeblock/svelar

Publishing

Run the monorepo release script from the repository root:

npm run smoke:ddd
npm run smoke:flat
npm run smoke:browser
npm run smoke:browser:headed
npm run smoke:prod
npm run smoke:db
npm run smoke:db:prod
npm run smoke:redis
npm run smoke:pdf
npm run smoke:search
npm run smoke:pgbouncer
npm run certify:inventory
npm run certify
npm run release:dry-run
npm run release

Run npm run certify before publishing. It prints the release certification inventory, runs the core test suite, then runs Redis, PDF, Meilisearch, S3, and PgBouncer/pg_stat_statements service smoke plus the full generated-app database and production-browser smoke gate. The smoke checks build and pack the local core package, scaffold real apps into the sibling svelar-testing-area, install UI components, run migrations and seeders, execute generated tests, verify production builds, and exercise the generated app in a real browser, including real EventSource checks for SSE public/private/presence channels. DDD smoke apps also receive an injected certification test that covers the intended route -> controller -> DTO/schema -> action -> service -> repository -> model -> resource flow, complex ORM queries, events/listeners, model observers, queues, middleware/rate limiting, sessions, SSE public/private/presence broadcasting, and Postmark/Resend/Mailtrap mail transport payloads across the configured database driver, Redis cache/session/BullMQ behavior when REDIS_URL is present, PDFKit/Gotenberg behavior when GOTENBERG_URL is present, Meilisearch Searchable indexing when MEILISEARCH_HOST is present, S3-compatible storage when S3_CERTIFICATION is present, and PostgreSQL through PgBouncer with pg_stat_statements when PGBOUNCER_CERTIFICATION is present. Use npm run smoke:browser:headed when you want to watch Chromium open and step through the browser smoke flow locally. The database, Redis, Gotenberg, Meilisearch, RustFS, and PgBouncer smoke scripts start Docker containers with random localhost ports, so they do not require 5432, 3306, 6379, 3000, 6432, 7700, or 9000 to be free. If Playwright has not downloaded Chromium locally yet, run cd ../svelar-testing-area/apps/svelar-smoke-ddd && npx playwright install chromium. The release script publishes @beeblock/svelar, which includes the svelar binary. npm blocks the unscoped svelar package name, so first-run scaffolding uses npx @beeblock/svelar new.

See the Getting Started guide for a complete walkthrough.

Features

Most first-party facades are also available from the root package, for example import { PDF, ApiKeys, Teams } from '@beeblock/svelar'. Subpath imports remain supported when you want a narrower import.

Official Plugins

CLI

npx @beeblock/svelar new my-app                  # scaffold with shadcn-svelte + all components
npx svelar update                      # update scaffold files without overwriting
npx svelar make:entity Invoice --module billing --fields "title:string,total:number" --crud
npx svelar make:model Post -m -c       # model + migration + controller
npx svelar make:service PaymentService # service class
npx svelar make:job SendEmail          # queue job
npx svelar make:task CleanupTokens     # scheduled task
npx svelar make:test Auth --feature    # feature test
npx svelar make:factory User --model User  # model factory
npx svelar migrate                     # run migrations
npx svelar schedule:run                # start the scheduler
npx svelar queue:work                  # process queue jobs
npx svelar tinker                      # interactive REPL
npx svelar plugin:install @beeblock/svelar-tags  # install + publish

# Deployment
npx svelar make:deploy                 # scaffold Docker + CI/CD + infra
npx svelar make:docker                 # Dockerfile, compose files, health endpoint
npx svelar make:ci                     # GitHub Actions workflow
npx svelar make:infra                  # droplet setup script + env template
npx svelar infra:setup                 # provision droplet + copy files via SSH
npx svelar dev:up                      # start dev containers (hot-reload)
npx svelar dev:logs                    # follow dev container logs
npx svelar prod:deploy                 # pull latest image + restart prod

Generated apps include npm run ui:install for manual --no-install setup. Use that instead of calling shadcn-svelte directly so Shadcn runtime packages stay in production dependencies for adapter-node builds.

54 commands available. Run npx svelar to see all commands.

Database Support

# SQLite (recommended for development)
npm install better-sqlite3

# PostgreSQL
npm install postgres

# MySQL
npm install mysql2

Requirements

• Node.js >= 20
• SvelteKit >= 2.0

License

MIT