Skip to content

lidge-jun/codexclaw / plugins/codexclaw/skills/dev-frontend

cxc-dev-frontend

Unverified

Use for frontend code and UI fixes. Triggers: CSS, responsive, animation, React, Vue, Svelte, Tailwind, redesign, anti-slop, 프론트엔드, UI 작업, 반응형, 디자인 수정.

FileKindSize
SKILL.mdskill md4.1 KB
agents/openai.yamlconfig169 B
examples/README.mdmarkdown2.6 KB
references/core/a11y-patterns.mdmarkdown5.9 KB
references/core/aesthetics.mdmarkdown16.9 KB
references/core/anti-slop-enforcement.mdmarkdown6.1 KB
references/core/anti-slop.mdmarkdown27.1 KB
references/core/asset-requirements.mdmarkdown24.3 KB
references/core/backend-contracts.mdmarkdown1.9 KB
references/core/brand-asset-sourcing.mdmarkdown4.0 KB
references/core/color-system.mdmarkdown5.7 KB
references/core/consistency-locks.mdmarkdown850 B
references/core/content-surface-pipeline.mdmarkdown7.2 KB
references/core/crud-ui.mdmarkdown2.5 KB
references/core/design-intake.mdmarkdown4.4 KB
references/core/dropdown-layer.mdmarkdown5.8 KB
references/core/i18n-global.mdmarkdown3.1 KB
references/core/implementation.mdmarkdown4.1 KB
references/core/iterative-design.mdmarkdown4.4 KB
references/core/korea-2026.mdmarkdown8.8 KB
references/core/layout-discipline.mdmarkdown10.6 KB
references/core/liquid-glass.mdmarkdown8.5 KB
references/core/logo-sections.mdmarkdown5.5 KB
references/core/mobile-ux.mdmarkdown6.1 KB
references/core/motion.mdmarkdown41.4 KB
references/core/performance-budget.mdmarkdown4.4 KB
references/core/platform-runtime.mdmarkdown5.0 KB
references/core/preflight-full.mdmarkdown4.0 KB
references/core/product-density.mdmarkdown1.9 KB
references/core/prototype-variants.mdmarkdown2.2 KB
references/core/reference-capture.mdmarkdown5.5 KB
references/core/render-grounding.mdmarkdown494 B
references/core/responsive-viewport.mdmarkdown5.4 KB
references/core/role-boundaries.mdmarkdown1.3 KB
references/core/routing-defaults.mdmarkdown943 B
references/core/section-level-sourcing.mdmarkdown8.7 KB
references/core/seo-baseline.mdmarkdown4.4 KB
references/core/soft-3d-asset-gates.mdmarkdown2.1 KB
references/core/theme-switching.mdmarkdown2.1 KB
references/core/token-source-divergence.mdmarkdown5.2 KB
references/core/top-bar.mdmarkdown5.5 KB
references/core/topic-index.mdmarkdown7.6 KB
references/core/typography-wrapping.mdmarkdown9.3 KB
references/core/ux-writing-ko.mdmarkdown2.3 KB
references/core/visual-audit-loop.mdmarkdown5.8 KB
references/core/visual-verification.mdmarkdown7.5 KB
references/core/wcag22-aa.mdmarkdown12.6 KB
references/stack-index.mdmarkdown1.3 KB
references/stacks/astro.mdmarkdown8.1 KB
references/stacks/mobile-native.mdmarkdown10.9 KB
references/stacks/nextjs.mdmarkdown5.7 KB
references/stacks/react.mdmarkdown8.6 KB
references/stacks/svelte.mdmarkdown8.4 KB
references/stacks/vanilla.mdmarkdown5.1 KB
scripts/README.mdmarkdown1.7 KB
scripts/bundle-artifact.shexecutablescript1.5 KB
scripts/init-artifact.shexecutablescript6.8 KB
scripts/shadcn-components.tar.gzbinary19.5 KB

references/stacks/svelte.md

View on GitHub
# Svelte 5 / SvelteKit 2 Stack

Last reviewed: 2026-06-16
Applies to: Svelte 5.x (Runes), SvelteKit 2.x
When to read: Building or modifying Svelte/SvelteKit projects
Canonical owner: dev-frontend

Read `core/aesthetics.md` + `core/anti-slop.md` first.

## 1. Runes (Svelte 5)

Svelte 5 replaces stores and reactive declarations with **Runes** — explicit reactivity primitives:

| Rune | Replaces | Purpose |
|------|----------|---------|
| `$state()` | `let x = 0` (reactive) | Declare reactive state |
| `$derived()` | `$: doubled = x * 2` | Computed value from state |
| `$effect()` | `$: { sideEffect() }` | Side effect on state change |
| `$props()` | `export let prop` | Declare component props |
| `$bindable()` | `export let value` (two-way) | Two-way bindable prop |
| `$inspect()` | `console.log` debugging | Dev-only reactive logging (stripped in prod) |

```svelte
<script>
  let { title, onSave } = $props();
  let count = $state(0);
  let doubled = $derived(count * 2);

  $effect(() => {
    console.log(`count changed to ${count}`);
    return () => { /* cleanup */ };
  });
</script>

<button onclick={() => count++}>
  {title}: {count} (doubled: {doubled})
</button>
```

Rules:
- Use `$state()` for all mutable reactive values — bare `let` is no longer reactive in Svelte 5.
- Prefer `$derived()` over `$effect()` for computed values — effects are for side effects only.
- `$effect()` runs after DOM update. Use `$effect.pre()` only when you need pre-DOM-update timing.
- Use `$inspect()` for debugging, never `console.log` inside `$effect()` — `$inspect` is stripped from production builds.
- Destructure `$props()` at the top of `<script>` — do not access `$$props` or `$$restProps` (Svelte 4 patterns).

## 2. SvelteKit 2

### Routing & Data Loading

```
src/routes/
├── +layout.svelte          # root layout
├── +layout.server.ts       # root layout data (runs on server)
├── +page.svelte            # home page
├── +page.server.ts         # home page data (runs on server)
├── blog/
│   ├── +page.svelte        # blog list
│   ├── +page.server.ts     # blog list data
│   └── [slug]/
│       ├── +page.svelte    # blog post
│       └── +page.server.ts # blog post data
└── api/
    └── posts/
        └── +server.ts      # API endpoint
```

| File | Runs On | Purpose |
|------|---------|---------|
| `+page.server.ts` → `load()` | Server only | Fetch data, access DB, read secrets |
| `+page.ts` → `load()` | Server + client | Universal data loading (no secrets) |
| `+page.svelte` | Client (hydrated) | Render UI with loaded data |
| `+server.ts` | Server only | API endpoints (GET, POST, PUT, DELETE) |
| `+layout.server.ts` | Server only | Shared layout data (auth, user session) |

### Form Actions

```typescript
// +page.server.ts
export const actions = {
  create: async ({ request, locals }) => {
    const data = await request.formData();
    const title = data.get('title');

    if (!title) {
      return fail(400, { title, missing: true });
    }

    await db.posts.create({ data: { title, author: locals.user.id } });
    redirect(303, '/blog');
  }
};
```

```svelte
<!-- +page.svelte -->
<script>
  import { enhance } from '$app/forms';
  let { form } = $props();
</script>

<form method="POST" action="?/create" use:enhance>
  <input name="title" value={form?.title ?? ''} />
  {#if form?.missing}<p class="error">Title required</p>{/if}
  <button>Create</button>
</form>
```

Rules:
- Always use `+page.server.ts` for data that requires secrets, DB access, or auth checks.
- Use form actions for mutations — progressive enhancement works without JavaScript.
- Validate server-side in form actions — client validation is UX, not security.
- Use `redirect()` and `error()` from `@sveltejs/kit`, not manual response construction.
- Use `$app/stores` sparingly in Svelte 5 — prefer `$props()` data flow from `load()`.

### SvelteKit Adapters

| Adapter | Target | Install |
|---------|--------|---------|
| `@sveltejs/adapter-auto` | Auto-detect (Vercel, Netlify, Cloudflare) | Default — included in new projects |
| `@sveltejs/adapter-node` | Node.js server (Docker, VPS) | `npm i -D @sveltejs/adapter-node` |
| `@sveltejs/adapter-static` | Static site (GitHub Pages, S3) | `npm i -D @sveltejs/adapter-static` |
| `@sveltejs/adapter-vercel` | Vercel (edge/serverless) | `npm i -D @sveltejs/adapter-vercel` |
| `@sveltejs/adapter-cloudflare` | Cloudflare Workers/Pages | `npm i -D @sveltejs/adapter-cloudflare` |

### Performance Characteristics

| Metric | Svelte 5 | React 19 | Vue 3.5 |
|--------|----------|----------|---------|
| Bundle size (hello world) | ~2 KB | ~45 KB | ~30 KB |
| Reactivity model | Compile-time (runes) | Runtime (fiber + hooks) | Runtime (proxy) |
| Virtual DOM | No — direct DOM updates | Yes | Yes |
| SSR streaming | SvelteKit `+page.server.ts` | React Server Components | Nuxt `useAsyncData` |
| Built-in transitions | Yes (`svelte/transition`) | No (need library) | Yes (`<Transition>`) |
| Scoped CSS | Default (`<style>`) | No (need CSS modules/Tailwind) | Default (`<style scoped>`) |

## 3. Component Patterns

### Snippets (Svelte 5 — replaces slots)

```svelte
<!-- Parent -->
<Card>
  {#snippet header()}
    <h2>Title</h2>
  {/snippet}
  {#snippet footer()}
    <button>Action</button>
  {/snippet}
  <p>Default content</p>
</Card>

<!-- Card.svelte -->
<script>
  let { header, footer, children } = $props();
</script>

<div class="card">
  {#if header}{@render header()}{/if}
  {@render children()}
  {#if footer}{@render footer()}{/if}
</div>
```

### Transitions & Animations

```svelte
<script>
  import { fly, fade } from 'svelte/transition';
  import { flip } from 'svelte/animate';

  let items = $state([]);
</script>

{#each items as item (item.id)}
  <div
    animate:flip={{ duration: 300 }}
    in:fly={{ y: 20, duration: 200 }}
    out:fade={{ duration: 150 }}
  >
    {item.name}
  </div>
{/each}
```

Rules:
- Use Snippets instead of slots — slots are deprecated in Svelte 5.
- Use `{@render}` for snippet rendering, not `<svelte:component>`.
- Scoped `<style>` is default — use `:global()` only when intentionally escaping scope.
- Prefer CSS transitions for simple effects; use Svelte transitions for enter/exit/list animations.
- Always provide `(key)` in `{#each}` blocks for stable identity.

## 4. Migration from Svelte 4

| Svelte 4 | Svelte 5 | Migration |
|----------|----------|-----------|
| `export let prop` | `let { prop } = $props()` | Destructure from `$props()` |
| `$: derived = x * 2` | `let derived = $derived(x * 2)` | Wrap in `$derived()` |
| `$: { sideEffect() }` | `$effect(() => { sideEffect() })` | Wrap in `$effect()` |
| `<slot />` | `{@render children()}` | Replace slots with snippets |
| `<slot name="x" />` | `{@render x()}` | Named slots → named snippets |
| `$$props` / `$$restProps` | `let { ...rest } = $props()` | Destructure with rest |
| Writable stores | `$state()` in `.svelte.ts` | Move to Rune-based state |
| `createEventDispatcher()` | Callback props | Pass functions via `$props()` |

```bash
# Automated migration (partial — review output manually)
npx svelte-migrate svelte-5
```

Rules:
- Migrate one component at a time — Svelte 5 components can coexist with Svelte 4 in the same project.
- Test each migrated component individually before proceeding.
- Stores in `.js`/`.ts` files still work — migrate to `.svelte.ts` Rune-based state when touching the file.
- `createEventDispatcher` → callback props is the biggest behavioral change; verify all event consumers.

## 5. Anti-Patterns

| Banned | Symptom | Fix |
|--------|---------|-----|
| `$effect()` for derived values | Unnecessary re-runs, stale value bugs | Use `$derived()` instead |
| Missing `(key)` in `{#each}` | Animation glitches, wrong element updates | Always provide a stable key |
| `$$props` in Svelte 5 | Deprecated, loses type safety | Destructure from `$props()` |
| Bare `let` expecting reactivity | Value does not update in template | Use `$state()` for reactive values |
| `on:click` syntax in Svelte 5 | Deprecated event directive | Use `onclick` attribute |

## Pre-flight

- [ ] All reactive state uses `$state()`, not bare `let`
- [ ] Computed values use `$derived()`, not `$effect()`
- [ ] Components use `$props()` destructuring, not `export let`
- [ ] `{#each}` blocks have stable keys
- [ ] Server-only data in `+page.server.ts`, not `+page.ts`
- [ ] Form actions validate server-side
- [ ] Slots migrated to Snippets (`{@render}`) in new/updated components
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall