flowstate-web Package Skill

Package: @epicdm/flowstate-web Repository: flowstate-web Path: . Version: 1.0.0

Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.

Primary Package Workflow

FlowState Web Cloudflare Deploy

Use this skill when deployment, build, or Worker runtime behavior changes.

Start Here

Read:

• package.json
• next.config.mjs
• open-next.config.ts
• wrangler.jsonc
• .forgejo/workflows if changing CI/deploy behavior

Build Model

npm run build first bundles src/workers/rxdb-shared-worker.ts into public/rxdb-shared-worker.js, then runs next build. OpenNext then emits the Cloudflare Worker bundle under .open-next.

Deployment Rules

1. Keep wrangler.jsonc environment variables aligned with staging, production, cloud, and cloud-dev modes.
2. Set secrets with Wrangler or CI secret storage; do not hardcode secrets into config.
3. Preserve RxDB premium aliases in next.config.mjs; community builds must keep the missing-premium shim working.
4. Keep Node-only dependencies out of the browser bundle through aliases or server-only boundaries.
5. Use OpenNext build/preview before deploy changes.

Verification

npm run typecheck
npm run build
npx opennextjs-cloudflare build

Use preview for deploy-risk changes:

npm run preview

Package Skill Inventory

@epicdm/flowstate-web Skill Inventory

Review Gate

@epicdm/flowstate-web Skill Review

Verdict

Pass with existing typecheck drift.

The skills are source-backed and focus on practical shell operation, manifest loading, local Marketplace/Launcher surfaces, and Cloudflare deployment.

Verification

• ASCII and skill frontmatter checks passed.
• npm test -- --runInBand passed: 10 suites, 96 tests.
• npm run typecheck failed existing strict typing errors in src/app/api/marketplace/installed/__tests__/route.test.ts where body is unknown at lines 99 and 100.

Run OpenNext when deployment behavior changes:

npx opennextjs-cloudflare build

Follow-Ups

• Reconcile README standalone dependency guidance with current file dependencies in package.json.
• Rebuild generated .flowstate/dojo content from reviewed package-local skills before publishing.

Start with this skill to understand the package purpose, then use the package-local focused skills for specific workflows. Keep this Dojo version aligned with ./package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.