convez.ai
MCP ServerDesenvolvimento WebIntermediário
kaufmann-dev

SvelteKit Template para IA

kaufmann-dev/sveltekit-template

Starter SvelteKit completo com suporte nativo a agentes MCP e infra de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Template opinado de SvelteKit pré-configurado para desenvolvimento orientado a agentes de IA, incluindo MCP servers, skills customizadas e stack completo (PostgreSQL, Drizzle ORM, Tailwind, Better Auth). Otimizado para projetos maiores com infraestrutura de desenvolvimento local (Podman, Vite, pnpm).

Instalação

$npx convez-ai kaufmann-dev/sveltekit-template

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Bootstrapping rápido de aplicações web full-stack com suporte a agentes IA
  • Projetos que precisam integrar MCP servers e custom skills Claude
  • Desenvolvimento local com PostgreSQL containerizado e hot-reload

Veredito

Template bem estruturado e realista para quem quer começar um projeto SvelteKit sério com suporte integrado a agentes IA. Stack maduro (Drizzle, Better Auth, Tailwind) mas exige familiaridade com ferramentas modernas (pnpm, Podman, SvelteKit). Recomendado para equipes que já usam Claude agents.

README

A tradução para o português deste README ainda está na fila.

SvelteKit Template

A strongly opinionated SvelteKit starter template for AI-driven development

CategoryTools
FrameworkSvelteKit, @sveltejs/adapter-node
UI & StylingTailwind CSS, shadcn-svelte, @lucide/svelte, mode-watcher
Data & AuthPostgreSQL, Drizzle ORM, Better Auth
Forms & ValidationSuperforms, Zod
EmailResend, better-svelte-email
InternationalisationParaglide
Testing & QualityVitest, svelte-check, ESLint, Prettier
Local DevelopmentVite, pnpm, Podman

Recommended for bigger projects, but not included by default:

  • Plausible for Observability
  • GlitchTip for Error Tracking
  • Playwright for E2E testing

Contents

Get Started

1. Copy this template into the project folder

mkdir my-app && cd my-app

pnpm dlx degit kaufmann-dev/sveltekit-template . --mode=tar --force

2. Create the configured SvelteKit app

[!WARNING] This command will overwrite this README.md. Back it up or rename it before running it. It will also add a Project Configuration section at the very top of AGENTS.md. Delete that section after running it.

pnpm dlx sv create --template minimal --types ts \
  --add tailwindcss="plugins:none" \
  drizzle="database:postgresql+client:postgres.js+docker:no" \
  eslint prettier \
  vitest="usages:unit,component" \
  paraglide="languageTags:en,de+demo:no" \
  sveltekit-adapter="adapter:node" \
  --install pnpm . --no-dir-check

3. Add the required non-sv packages

pnpm add mode-watcher @lucide/svelte sveltekit-superforms zod resend better-svelte-email better-auth

pnpm dlx shadcn-svelte@latest init \
  --css src/routes/layout.css \
  --lib-alias '$lib' \
  --components-alias '$lib/components' \
  --ui-alias '$lib/components/ui' \
  --utils-alias '$lib/utils' \
  --hooks-alias '$lib/hooks'

This command will prompt you for the design system. I personally like Rhea.

4. Install the shadcn-svelte components

pnpm dlx shadcn-svelte@latest add --all

Development Commands

Use pnpm for project scripts:

pnpm dev
pnpm check
pnpm lint
pnpm format
pnpm build
pnpm preview

Development Database

Update the .env file generated by sv create with these development values:

POSTGRES_USER="postgres"
POSTGRES_PASSWORD="postgres"
POSTGRES_DB="postgres"
DATABASE_URL="postgres://postgres:postgres@localhost:5432/postgres"
ORIGIN="http://localhost:5173"

Run PostgreSQL locally with Podman:

podman run \
  --name postgres-sveltekit \
  --env-file .env \
  --publish 5432:5432 \
  --volume postgres-sveltekit-data:/var/lib/postgresql/data \
  --detach \
  postgres:18-alpine

Keep the generated BETTER_AUTH_SECRET value, or replace it with a new high-entropy secret. If you change POSTGRES_USER, POSTGRES_PASSWORD, or POSTGRES_DB, update DATABASE_URL to match.

Useful Podman commands:

podman start postgres-sveltekit
podman stop postgres-sveltekit
podman logs postgres-sveltekit

Included

  • AGENTS.md with SvelteKit, Svelte 5, shadcn-svelte, auth, database, testing, and tooling instructions.
  • pnpm-workspace.yaml with pnpm build-script approvals for the selected stack.
  • .agents/skills/ and skills-lock.json with project-local skills, including the Svelte skills from @sveltejs/mcp.
  • MCP configuration for Codex, OpenCode, Antigravity, and Claude Code.
  • Svelte file-editor subagents for Codex, OpenCode, Antigravity, and Claude Code.

MCP Servers

Enabled by default:

  • svelte
  • shadcn-svelte

Optional MCP servers:

  • postgres via DATABASE_URL
  • resend via RESEND_API_KEY

If you decide to use them, Codex & OpenCode already have them configured, but disabled. For Antigravity & Claude Code, you will need to add the configuration manually.

Assumptions

  • Node is installed
  • pnpm is installed and used as the package manager
  • podman is installed and used for the local development database
Ver o original no GitHub

Bom para

Relacionados