LocalSite-ai: Instructions file for Codex

You are able to use the Svelte MCP server, where you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:

Available Svelte MCP Tools:

1. list-sections

Use this FIRST to discover all available documentation sections. Returns a structured list with titles, use_cases, and paths. When asked about Svelte or SvelteKit topics, ALWAYS use this tool at the start of the chat to find relevant sections.

2. get-documentation

Retrieves full documentation content for specific sections. Accepts single or multiple sections. After calling the list-sections tool, you MUST analyze the returned documentation sections (especially the use_cases field) and then use the get-documentation tool to fetch ALL documentation sections that are relevant for the user's task.

3. svelte-autofixer

Analyzes Svelte code and returns issues and suggestions. You MUST use this tool whenever writing Svelte code before sending it to the user. Keep calling it until no issues or suggestions are returned.

4. playground-link

Generates a Svelte Playground link with the provided code. After completing the code, ask the user if they want a playground link. Only call this tool after user confirmation and NEVER if code was written to files in their project.

---

Project Overview

LocalSite-AI generates complete, self-contained HTML/CSS/JS web pages from natural language prompts using AI. Users pick a provider and model, describe what they want, and get a live preview with an editable Monaco code editor.

Tech stack: SvelteKit 2, Svelte 5 (runes), Deno 2, Tailwind CSS 3, Vercel AI SDK v5, Monaco Editor, Paneforge, svelte-sonner, @lucide/svelte.

Runtime: Deno 2 (deno task dev/build/check/lint). package.json retains npm scripts for compatibility but Deno is the primary toolchain.

Architecture

src/
  routes/
    +page.svelte                  Main page: WelcomeView -> GenerationView
    +layout.svelte                Global layout, Toaster
    +layout.ts                    SSR disabled (ssr = false)
    +error.svelte                 Error boundary
    api/
      generate-code/+server.ts    POST: streams NDJSON (text + reasoning)
      get-models/+server.ts       GET: models for provider; POST: list providers
      get-default-provider/+server.ts  GET: default provider from env
  lib/
    state/
      code-generation.svelte.ts   CodeGeneration class (rune-based state)
    server/providers/
      config.ts                   LLMProvider enum, config registry, env helpers
      provider.ts                 9 provider client classes, generateCodeStream()
      prompts.ts                  DEFAULT_SYSTEM_PROMPT, THINKING_SYSTEM_PROMPT
    components/
      [see README for full component list]
    ui/                           8 hand-rolled primitives (Button, Select, etc.)