PokeR/openspec/specs/sveltekit-project/spec.md

SvelteKit Project

Purpose: Scaffold a SvelteKit project with TypeScript configuration and standard project structure.

Requirements

Requirement: Project scaffolding with SvelteKit template

The system SHALL create a SvelteKit project using npx sv create with the minimal template and TypeScript enabled.

Scenario: Project creation completes successfully

• WHEN npx sv create is executed with --types ts --template minimal flags
• THEN a SvelteKit project structure is generated with all required configuration files

Requirement: TypeScript configuration

The system SHALL configure TypeScript as the primary language for both .ts files and lang="ts" in .svelte components.

Scenario: TypeScript files are generated

• WHEN the project is created with --types ts option
• THEN tsconfig.json exists and extends .svelte-kit/tsconfig.json

Requirement: Standard configuration files

The system SHALL generate all standard SvelteKit configuration files including svelte.config.js, vite.config.js, and package.json.

Scenario: Configuration files exist

• WHEN the project scaffolding completes
• THEN svelte.config.js with adapter-auto, vite.config.js with sveltekit plugin, and package.json with required dependencies are present

Requirement: Standard project structure

The system SHALL create the standard SvelteKit directory structure with src/routes, src/lib, static, and template files.

Scenario: Directory structure is correct

• WHEN the project scaffolding completes
• THEN directories src/routes/, src/lib/, and static/ exist, and src/app.html contains SvelteKit template placeholders

Requirement: Development server functionality

The system SHALL be able to start a development server using npm run dev.

Scenario: Dev server starts successfully

• WHEN npm run dev is executed after dependencies are installed
• THEN the development server runs on localhost and serves the SvelteKit application