Starter Kit

An opinionated SvelteKit starter, with the following opinions:

• TypeScript
• Oxfmt
• ESLint
• MCP (incl. Claude, Cursor, Gemini)
• Bun
• Component & Library aliases
• Viewport-fit cover
• Ignore lock files

Along with these features:

• Analytics, Button, Cookies, Loader starter components
• CSS reset (kitto)
• Global CSS with sensible defaults and fluid type vars (kitto)
• Overlay component for pixel perfect frontend (kitto)
• Preferences store backed by localstorage (kitto)
• Security headers in hooks
• Size CSS shorthand (kitto)
• SSL support with mkcert
• Svelte Check RS
• UI state store
• Variablised media query breakpoints (kitto)

Creating a project

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

# create a new project
bunx degit https://github.com/mattpilott/starter-kit my-app

To recreate the underlying SvelteKit setup use this configuration:

# recreate this project
bun x sv@0.16.4 create --template minimal --types ts --add eslint sveltekit-adapter="adapter:auto" mcp="ide:claude-code,cursor,gemini+setup:remote" --install bun .
bun add -d oxfmt

Developing

Once you've created a project and installed dependencies with bun i, start a development server:

bun dev

# or start the server and open the app in a new browser tab
bun dev -- --open

Building

To create a production version of your app:

bun run build

You can preview the production build with bun preview.

Additional Features

Height & width shorthand

Define both height and width in a single line.

div {
	size: 10rem;
}

Variable media queries

Define your breakpoints just once in the Vite config and use them in your CSS and Svelte components.

@media (--from-mobile) and (--until-tablet) {
	color: blue;
	size: 10px; /* this instead of height + width */
}

<Overlay mobile="/mobile.jpg@393" desktop="/desktop.jpg@1920" />

Notes

Local SSL

For local trusted SSL's rather than untrusted self-signed (like that of vite-basic-ssl) use mkcert.

brew install mkcert nss

mkcert -install

mkcert localhost

Drop the generated pems next to vite.config.ts and the kitto() plugin serves HTTPS automatically — any mkcert filenames work (localhost.pem, myapp.test.pem, …), no config needed. Without certs it logs a warning and runs over HTTP.