菜单
Entry point for building Dart and Flutter apps on Convex with the dartvex packages. Use when a project uses dartvex, dartvex_flutter, dartvex_codegen, dartvex_local, or dartvex_auth_better, or when the user wants to connect a Dart/Flutter app to a Convex backend. Routes to the focused dartvex skills.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build reactive Flutter UI on Convex with dartvex_flutter - live query widgets, mutations with optimistic updates, gapless pagination, connection and auth-state banners. Use when building lists/feeds/chat that update in real time, infinite scroll, offline indicators, or any Flutter widget driven by Convex data.
Generate type-safe Dart bindings for a Convex backend with dartvex_codegen - typed methods instead of raw function-name strings and maps. Use when setting up codegen, regenerating after backend changes, committing a function spec safely, or when the user mentions dartvex_codegen, function_spec.json, or typed Convex APIs in Dart.
Connect a Dart or Flutter app to a Convex backend with the dartvex SDK - add dependencies, create the client, run the first query, mutation, and live subscription. Use when starting a new dartvex integration, when the user says "use Convex from Flutter/Dart", or when wiring an existing app to a Convex deployment.
Add authentication to a Dart/Flutter app on Convex - Better Auth email/password and magic links via dartvex_auth_better, session persistence across restarts, or manual JWT auth for any OIDC provider. Use when the user wants login/signup, session restore, Better Auth, or to authenticate the dartvex Convex client.
Add offline support to a dartvex Convex app with dartvex_local - SQLite query cache served when the network is down, offline mutation queue with ordered replay, and local optimistic patches. Use when the user wants offline-first behavior, airplane-mode resilience, queued writes, or mentions dartvex_local.
Test Flutter widgets and app logic that use dartvex without a live Convex backend - FakeConvexClient stubs for queries, mutations, and subscription pushes in widget tests. Use when writing or fixing tests for dartvex-based screens, or when tests should not hit a real deployment.
| name | dartvex |
| description | Entry point for building Dart and Flutter apps on Convex with the dartvex packages. Use when a project uses dartvex, dartvex_flutter, dartvex_codegen, dartvex_local, or dartvex_auth_better, or when the user wants to connect a Dart/Flutter app to a Convex backend. Routes to the focused dartvex skills. |
| license | MIT |
| metadata | {"author":"AndreFrelicot","ecosystem-version":"0.2.0"} |
Dartvex is a pure-Dart client SDK for Convex. It covers the full sync protocol (reactive subscriptions, mutations, actions), auth, file storage, offline support, Flutter widgets, and a type-safe code generator. Five packages on pub.dev:
| Package | Role |
|---|---|
dartvex | Core client — WebSocket sync, subscriptions, auth, storage |
dartvex_flutter | Flutter widgets — provider, query/mutation builders, images |
dartvex_codegen | CLI — type-safe Dart bindings from a Convex function spec |
dartvex_local | Offline — SQLite query cache and mutation queue |
dartvex_auth_better | Better Auth adapter for self-hosted authentication |
| Task | Skill |
|---|---|
| Connect a Dart/Flutter app to Convex, first query/mutation | dartvex-quickstart |
| Generate type-safe Dart bindings from a Convex backend | dartvex-generate-bindings |
| Email/password or magic-link auth with Better Auth | dartvex-setup-auth |
| Reactive lists, pagination, optimistic UI, connection banners | dartvex-build-realtime-ui |
| Offline cache and queued mutations | dartvex-setup-offline |
| Upload files and display stored images | dartvex-upload-files |
| Unit/widget tests without a live backend | dartvex-test-with-fakes |
If a needed skill from the table is not installed, suggest installing it:
npx skills add AndreFrelicot/dartvex
npx skills add get-convex/agent-skills. Reference: https://docs.convex.devnpx skills add flutter/skills.https://your-deployment.convex.cloud placeholders; inject the
real URL at run time (--dart-define, environment, or gitignored config).dartvex: ^0.2.0 with dartvex_flutter: ^0.2.0, etc.).int/double map to Convex v.number(). Use
convexInt64(value) or BigInt only for v.int64() arguments.