@cioky/vike-create

Scaffold a Vike + Ripple TS project.

Part of the vike-ripple monorepo.

Usage

# With Tailwind CSS (default)
npx @cioky/vike-create my-app

# With Panda CSS
npx @cioky/vike-create my-app --style pandacss

# Without a CSS framework
npx @cioky/vike-create my-app --style none

# With Cloudflare Workers support
npx @cioky/vike-create my-app --style tailwind --cloudflare

# With Remult (SSE live query everywhere)
npx @cioky/vike-create my-app --style tailwind --remult

# With Remult + Cloudflare (DO-based realtime)
npx @cioky/vike-create my-app --style tailwind --remult --cloudflare

Flags

| Flag | Description | |------|-------------| | --style tailwind | Tailwind CSS v4 (default) | | --style pandacss | Panda CSS | | --style none | No CSS framework | | --cloudflare | Cloudflare Workers setup (wrangler, D1, DO config) | | --remult | Remult ORM with realtime subscriptions | | --remult --cloudflare | Remult with Durable Object-based realtime via remult-partykit |

What's included

The scaffold creates:

• Vike pages (pages/index, pages/about) with SSR
• Ripple TS .tsrx file support
• @cioky/vike-core config (Layout, Head, hooks)
• CSS framework config (tailwind.css or panda.config.ts)
• Cloudflare Workers config when --cloudflare is set
• Remult + realtime subscription setup when --remult is set

Todo CRUD pages (when --remult)

When --remult is used, the scaffold includes a full Todo CRUD demo:

• /todo — List, add, toggle completion, and delete tasks using useQuery and mutation
• /todo/mutations — Same CRUD with detailed mutation state
• /todo/infinite — Infinite-scrolling paginated list with useInfiniteQuery
• entities/task.ts — Remult Task entity with id, title, completed, createdAt

These demo pages use @cioky/ripple-query and @cioky/ripple-query-remult for reactive data fetching with automatic cache invalidation after mutations.

Generated Packages

| Package | Installed when | |---------|---------------| | @cioky/vike-core | Always | | @cioky/vike-tailwindcss | --style tailwind | | @cioky/vike-pandacss | --style pandacss | | @cioky/ripple-query | --remult | | @cioky/ripple-query-remult | --remult | | remult-partykit | --remult --cloudflare |

See the main repo for per-package documentation.