convez.ai
SkillDesenvolvimento WebAvançado
dbjpanda

Starter Skill — Scaffold Convex Full-Stack

dbjpanda/starter-skill

Gera web + mobile + backend Convex em um monorepo Bun pronto para usar

Ver no GitHub
InicialPluginScore · de 0 a 100

Uma skill para Claude Code que gera um projeto full-stack pronto para produção com Convex, Bun monorepo, React 19 com TanStack Router/Query para web e Expo SDK 56 para mobile nativo. Inclui autenticação Convex Auth em ambas plataformas, Base UI com Tailwind v4 e componentes compartilhados.

Instalação

$npx convez-ai dbjpanda/starter-skill

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á 5 meses
Versão
v0.1.3
Issues abertas
0
Contribuidores
2

Casos de uso

  • Bootstrapear projetos full-stack modernos com web e mobile sincronizados
  • Configurar autenticação cross-platform com Convex Auth
  • Acelerar setup de monorepo Bun com padrões battle-tested

Veredito

Skill robusto e battle-tested que resolve o problema real de scaffolding full-stack moderno. Exige experiência com Convex, TanStack e Expo para aproveitar todo o potencial, mas o resultado é arquitetura sólida validada em produção.

README

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

starter-skill

A Claude Code skill (packaged as a marketplace plugin) that scaffolds a production-shaped Convex full-stack starter:

  • Bun-workspace monorepo with three packages sharing one backend
  • packages/backend — Convex functions, schema, Convex Auth, components
  • packages/web — React 19 + Vite + TanStack Router + TanStack Query + shadcn UI on Base UI + Tailwind v4
  • packages/mobile — Expo SDK 56 + expo-router NativeTabs + @expo/ui (SwiftUI / Jetpack Compose) + NativeWind
  • Convex Auth (Password) wired on both web and mobile (SecureStore on device)

The skill is CLI-first (drives bun, convex, create-expo-app, expo install, shadcn), starts on a local Convex deployment, and pulls the relevant Convex/Expo/shadcn marketplace skills before scaffolding.

Install

From Claude Code:

/plugin marketplace add dbjpanda/starter-skill
/plugin install starter-skill@starter-skill

(Or add this repo as a marketplace and install the starter-skill plugin, which ships a single skill — also named starter-skill.)

Use

Just ask Claude to start a project, e.g.:

"Spin up a new web + mobile app on Convex." "Bootstrap a Bun monorepo with a TanStack web app and an Expo native app."

The starter-skill triggers, confirms scope (backend / web / mobile), pulls the supporting skills, and scaffolds each layer in order.

Layout

starter-skill/
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
└── skills/
    └── starter-skill/
        ├── SKILL.md                       # umbrella orchestrator
        └── references/
            ├── 01-monorepo.md             # Bun workspaces, root scripts, exports map
            ├── 02-backend-convex.md       # convex dev --once, schema/functions, components
            ├── 03-auth.md                 # Convex Auth on web + mobile (SecureStore)
            ├── 04-web-tanstack.md         # TanStack Router + Query ↔ Convex bridge
            ├── 05-web-components-baseui.md # Base UI shadcn (render, not asChild), Tailwind v4
            ├── 06-mobile-expo.md          # Expo 56, NativeTabs, @expo/ui, NativeWind, MMKV
            └── 07-cli-and-skills.md       # CLI cheatsheet, supporting skills, gotchas

Modeled on real production apps (a TanStack/Convex web platform and an Expo SDK 56/Convex native app) so the patterns are battle-tested, not invented.

Validated

The canonical files were scaffold-tested end-to-end (June 2026, bun 1.3.11):

  • Backend — a real local Convex deployment via CONVEX_AGENT_MODE=anonymous bunx convex dev --once: schema + authTables, the by_user indexes, all components (rateLimiter/actionRetrier/workpool), and the tasks functions pushed and validated.
  • Web — tsc clean against @base-ui/react@1.5.0, @tanstack/react-query@5.100, @convex-dev/react-query@0.1 (the Convex↔TanStack bridge + Base UI button).
  • Mobile — tsc clean against Expo SDK 56.0.8 (@expo/ui@56, expo-router@56 NativeTabs, react-native-mmkv@4, expo-secure-store).
  • Monorepo — the @app/backend exports map resolves the generated api in both clients.

The dry-run also corrected three real bugs (bun --filter add, the useAppQuery typing, and react-native-mmkv v4's createMMKV/remove API) — fixed in v0.1.3.

Ver o original no GitHub

Bom para

Relacionados