@appsforgood/next-supabase-kit 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/BEST_PRACTICE_EVIDENCE.md +45 -0
  2. package/CHANGELOG.md +44 -0
  3. package/CODE_OF_CONDUCT.md +26 -0
  4. package/CONTRIBUTING.md +48 -0
  5. package/DOGFOOD.md +121 -0
  6. package/GOVERNANCE.md +45 -0
  7. package/LICENSE +21 -0
  8. package/README.md +251 -0
  9. package/REPOSITORY_SETTINGS.md +70 -0
  10. package/RESEARCH_CITATION_POLICY.md +26 -0
  11. package/SECURITY.md +29 -0
  12. package/SUPPLY_CHAIN.md +55 -0
  13. package/SUPPORT.md +28 -0
  14. package/UPGRADE.md +77 -0
  15. package/agents/deployment-observability-engineer.md +13 -0
  16. package/agents/docs-maintainer.md +17 -0
  17. package/agents/frontend-design-lead.md +22 -0
  18. package/agents/lead-architect.md +25 -0
  19. package/agents/marketing-copy-lead.md +20 -0
  20. package/agents/nextjs-engineer.md +20 -0
  21. package/agents/planner.md +20 -0
  22. package/agents/qa-engineer.md +19 -0
  23. package/agents/research-analyst.md +13 -0
  24. package/agents/security-reviewer.md +16 -0
  25. package/agents/supabase-postgres-engineer.md +19 -0
  26. package/assistant-adapters/README.md +28 -0
  27. package/assistant-adapters/claude-code-subagents.md +37 -0
  28. package/assistant-adapters/codex-agents.md +35 -0
  29. package/assistant-adapters/cursor-agent-kit.mdc +30 -0
  30. package/assistant-adapters/github-copilot-instructions.md +35 -0
  31. package/assistant-adapters/github-next-supabase.instructions.md +28 -0
  32. package/assistant-adapters/model-selection/claude-code-subagents-with-models.md +32 -0
  33. package/assistant-adapters/model-selection/codex-config.example.toml +29 -0
  34. package/assistant-adapters/model-selection/cursor-model-selection.mdc +24 -0
  35. package/assistant-adapters/model-selection/github-copilot-model-selection.md +20 -0
  36. package/checklists/accessibility.md +12 -0
  37. package/checklists/agent-council.md +13 -0
  38. package/checklists/brand-content.md +15 -0
  39. package/checklists/deployment.md +10 -0
  40. package/checklists/design-critique.md +13 -0
  41. package/checklists/frontend-distinctiveness.md +12 -0
  42. package/checklists/frontend-product-quality.md +13 -0
  43. package/checklists/frontend-quality.md +20 -0
  44. package/checklists/marketing-copy.md +11 -0
  45. package/checklists/owasp.md +12 -0
  46. package/checklists/rls.md +10 -0
  47. package/checklists/testing.md +12 -0
  48. package/checklists/upgrade.md +13 -0
  49. package/checklists/visual-regression.md +11 -0
  50. package/design-adapters/claude-design.prompt.md +27 -0
  51. package/design-adapters/figma.prompt.md +18 -0
  52. package/design-adapters/google-stitch.prompt.md +36 -0
  53. package/design-adapters/human-designer-brief.prompt.md +36 -0
  54. package/design-briefs/admin-dashboard.md +21 -0
  55. package/design-briefs/ai-workflow-product.md +25 -0
  56. package/design-briefs/community-social.md +26 -0
  57. package/design-briefs/content-app.md +21 -0
  58. package/design-briefs/ecommerce.md +25 -0
  59. package/design-briefs/education-course.md +25 -0
  60. package/design-briefs/marketplace.md +21 -0
  61. package/design-briefs/portfolio-venue.md +25 -0
  62. package/design-briefs/saas.md +21 -0
  63. package/design-briefs/tool.md +21 -0
  64. package/dist/index.d.ts +2 -0
  65. package/dist/index.js +3521 -0
  66. package/dist/index.js.map +1 -0
  67. package/examples/next-supabase-installed/.agent-kit/agent-roster.json +228 -0
  68. package/examples/next-supabase-installed/.agent-kit/manifest.json +58 -0
  69. package/examples/next-supabase-installed/.agent-kit/model-routing.json +164 -0
  70. package/examples/next-supabase-installed/.agent-kit/overrides.json +9 -0
  71. package/examples/next-supabase-installed/README.md +15 -0
  72. package/examples/next-supabase-installed/audit-output.json +336 -0
  73. package/examples/next-supabase-installed/tree.txt +38 -0
  74. package/model-routing/default-model-routing.json +164 -0
  75. package/package.json +98 -0
  76. package/profiles/admin-app.md +17 -0
  77. package/profiles/content-app.md +17 -0
  78. package/profiles/marketplace.md +17 -0
  79. package/profiles/saas.md +17 -0
  80. package/profiles/stack-next-firebase.md +25 -0
  81. package/profiles/stack-next-postgres.md +24 -0
  82. package/profiles/stack-remix-supabase.md +24 -0
  83. package/prompts/audit-project-setup.md +28 -0
  84. package/prompts/brand-content-intake.md +17 -0
  85. package/prompts/copy-review.md +15 -0
  86. package/prompts/council-session-review.md +17 -0
  87. package/prompts/creative-direction-matrix.md +22 -0
  88. package/prompts/design-critique-gate.md +28 -0
  89. package/prompts/docs-update.md +16 -0
  90. package/prompts/frontend-design-review.md +29 -0
  91. package/prompts/frontend-distinctiveness-benchmark.md +32 -0
  92. package/prompts/frontend-product-quality-scorecard.md +35 -0
  93. package/prompts/implement-feature.md +14 -0
  94. package/prompts/migration-review.md +14 -0
  95. package/prompts/screenshot-review.md +27 -0
  96. package/prompts/security-review.md +17 -0
  97. package/prompts/upgrade-review.md +18 -0
  98. package/prompts/visual-qa-plan.md +16 -0
  99. package/research/proposed-updates.md +70 -0
  100. package/research/scan-config.json +261 -0
  101. package/research/scan-plan.md +24 -0
  102. package/research/summaries/.gitkeep +1 -0
  103. package/research/summaries/agent-workflow-patterns.md +37 -0
  104. package/research/summaries/creative-design-patterns.md +38 -0
  105. package/research/summaries/design-critique-patterns.md +34 -0
  106. package/research/summaries/docs-and-agent-patterns.md +64 -0
  107. package/research/summaries/dogfood-adoption-patterns.md +33 -0
  108. package/research/summaries/frontend-design-patterns.md +64 -0
  109. package/research/summaries/frontend-distinctiveness-benchmark-patterns.md +38 -0
  110. package/research/summaries/frontend-product-quality-rubric-patterns.md +37 -0
  111. package/research/summaries/maturity-model-patterns.md +29 -0
  112. package/research/summaries/nextjs-patterns.md +65 -0
  113. package/research/summaries/repo-health-patterns.md +41 -0
  114. package/research/summaries/scan-overview.md +46 -0
  115. package/research/summaries/security-patterns.md +64 -0
  116. package/research/summaries/supabase-rls-patterns.md +54 -0
  117. package/research/summaries/supply-chain-patterns.md +38 -0
  118. package/research/summaries/testing-patterns.md +63 -0
  119. package/research/summaries/upgrade-lifecycle-patterns.md +26 -0
  120. package/research/summaries/visual-qa-patterns.md +39 -0
  121. package/rosters/next-supabase-default-council.json +228 -0
  122. package/schemas/agent-roster.schema.json +54 -0
  123. package/schemas/audit-report.schema.json +50 -0
  124. package/schemas/correction-rules.schema.json +32 -0
  125. package/schemas/council-session.schema.json +65 -0
  126. package/schemas/model-routing.schema.json +72 -0
  127. package/schemas/project-context.schema.json +94 -0
  128. package/schemas/session-event.schema.json +46 -0
  129. package/schemas/studio-session.schema.json +48 -0
  130. package/skills/accessibility-wcag.md +15 -0
  131. package/skills/agent-handoff-tracing.md +44 -0
  132. package/skills/best-practice-maturity-review.md +26 -0
  133. package/skills/content-first-design.md +50 -0
  134. package/skills/conversion-copywriting.md +38 -0
  135. package/skills/deployment-observability.md +14 -0
  136. package/skills/docs-maintainer.md +19 -0
  137. package/skills/frontend-design-system.md +68 -0
  138. package/skills/frontend-distinctiveness-benchmark.md +40 -0
  139. package/skills/frontend-product-quality-rubric.md +59 -0
  140. package/skills/landing-page-copy.md +29 -0
  141. package/skills/nextjs-app-router.md +18 -0
  142. package/skills/onboarding-empty-state-copy.md +37 -0
  143. package/skills/owasp-security-review.md +19 -0
  144. package/skills/planning-council.md +21 -0
  145. package/skills/positioning-messaging.md +42 -0
  146. package/skills/postgres-migrations.md +14 -0
  147. package/skills/product-voice-tone.md +35 -0
  148. package/skills/reference-led-design-critique.md +48 -0
  149. package/skills/supabase-auth-rls.md +20 -0
  150. package/skills/testing-qa.md +15 -0
  151. package/skills/upgrade-maintenance.md +32 -0
  152. package/skills/visual-regression-qa.md +42 -0
  153. package/templates/next-supabase/AGENTS.md +138 -0
  154. package/templates/next-supabase/AGENT_ROSTER.md +98 -0
  155. package/templates/next-supabase/ASSISTANT_ADAPTERS.md +82 -0
  156. package/templates/next-supabase/COUNCIL.md +54 -0
  157. package/templates/next-supabase/DECISIONS.md +45 -0
  158. package/templates/next-supabase/DEPLOYMENT.md +45 -0
  159. package/templates/next-supabase/DESIGN.md +171 -0
  160. package/templates/next-supabase/DOCS.md +62 -0
  161. package/templates/next-supabase/MESSAGING.md +81 -0
  162. package/templates/next-supabase/MODEL_ROUTING.md +109 -0
  163. package/templates/next-supabase/QUALITY_GATES.md +87 -0
  164. package/templates/next-supabase/SECURITY.md +54 -0
  165. package/templates/next-supabase/SKILLS.md +221 -0
  166. package/templates/next-supabase/SPEC.md +114 -0
  167. package/templates/next-supabase/STYLE_GUIDE.md +104 -0
  168. package/templates/next-supabase/TESTING.md +68 -0
  169. package/templates/next-supabase/UPGRADE.md +59 -0
@@ -0,0 +1,25 @@
1
+ # Education Or Course Design Brief
2
+
3
+ Use when designing learning platforms, course pages, lesson players, cohort dashboards, school tools, tutorials, docs learning paths, or assessment flows.
4
+
5
+ ## First Screen
6
+
7
+ Show the learner's current path, next lesson, progress, assessment, or decision. Do not default to a generic inspirational landing page.
8
+
9
+ ## Required Inputs
10
+
11
+ - Learner level, goal, prior knowledge, and constraints.
12
+ - Course structure: modules, lessons, exercises, assessments, resources, cohorts, deadlines.
13
+ - Content types: text, video, code, quiz, project, downloadable material, instructor notes.
14
+ - Success measures: completion, mastery, certification, practice, feedback, community support.
15
+
16
+ ## Avoid
17
+
18
+ - Progress bars without meaningful next action.
19
+ - Generic course cards with no prerequisites or outcomes.
20
+ - Overly decorative dashboards that obscure learning state.
21
+ - Accessibility gaps in video, code, quizzes, or keyboard navigation.
22
+
23
+ ## Required States
24
+
25
+ Not started, in progress, blocked, overdue, completed, failed assessment, feedback pending, offline or slow media, mobile lesson view.
@@ -0,0 +1,21 @@
1
+ # Marketplace Design Brief
2
+
3
+ Use this brief for two-sided marketplaces, listings, booking flows, buyer portals, and seller dashboards.
4
+
5
+ ## Product Signals
6
+
7
+ - First screen should expose searchable supply, buyer intent, or seller fulfillment work.
8
+ - Avoid fake metrics and placeholder listings.
9
+ - Make trust, availability, pricing, location, eligibility, and next action clear.
10
+
11
+ ## Required States
12
+
13
+ - No results, filtered results, unavailable item, pending approval, sold/booked, dispute, loading, error, and success states.
14
+ - Buyer and seller role differences.
15
+ - Mobile search, compare, save, and contact flows.
16
+
17
+ ## Design Direction
18
+
19
+ - Use visual assets that reveal the actual product, place, or listing condition.
20
+ - Prioritize comparison, sorting, saved items, trust signals, and clear transaction steps.
21
+ - Tokens must include status colors for availability, verification, warnings, and completion.
@@ -0,0 +1,25 @@
1
+ # Portfolio Or Venue Design Brief
2
+
3
+ Use when designing portfolios, personal sites, studios, restaurants, hotels, venues, galleries, agencies, clinics, real-estate showcases, or object/place-focused pages.
4
+
5
+ ## First Screen
6
+
7
+ The person, place, brand, work, or object must be immediately visible through specific imagery, identity, or proof of work. Do not make the first screen a generic slogan with abstract decoration.
8
+
9
+ ## Required Inputs
10
+
11
+ - The thing being showcased: person, venue, product, project, place, or service.
12
+ - Real assets: photos, case studies, menus, rooms, locations, artifacts, testimonials, availability, or press.
13
+ - Visitor intent: book, enquire, inspect, compare, visit, hire, buy, or read.
14
+ - Brand tone and sensory details: material, atmosphere, pace, craft, audience, locality.
15
+
16
+ ## Avoid
17
+
18
+ - Generic agency cards.
19
+ - Dark blurred background photos that hide the actual subject.
20
+ - Fake logos, fake awards, or vague testimonials.
21
+ - Hero sections that do not reveal the real work or place.
22
+
23
+ ## Required States
24
+
25
+ Image loading, missing asset, enquiry error, booking unavailable, mobile gallery, map/location fallback, long-name wrapping, accessibility for media and carousels.
@@ -0,0 +1,21 @@
1
+ # SaaS Design Brief
2
+
3
+ Use this brief for subscription products, team workspaces, account portals, and workflow SaaS.
4
+
5
+ ## Product Signals
6
+
7
+ - First screen should show the core job: pipeline, inbox, workspace, editor, report, or operational queue.
8
+ - Avoid generic hero-first pages unless the request is explicitly marketing.
9
+ - Make plan, billing, team, permission, and usage states easy to scan.
10
+
11
+ ## Required States
12
+
13
+ - Trial, active, past due, canceled, and upgrade-required account states.
14
+ - Empty workspace, no data yet, loading, error, disabled, and success states.
15
+ - Mobile layout for the primary repeated workflow, not just the settings screen.
16
+
17
+ ## Design Direction
18
+
19
+ - Use restrained density, predictable navigation, and domain-specific labels.
20
+ - Prefer tables, split panes, timelines, and command surfaces over decorative cards.
21
+ - Tokens must define semantic status colors, spacing density, radius, and focus states.
@@ -0,0 +1,21 @@
1
+ # Tool Design Brief
2
+
3
+ Use this brief for calculators, generators, editors, workflow tools, dashboards, and focused utilities.
4
+
5
+ ## Product Signals
6
+
7
+ - First screen should be the usable tool, not a landing page explaining the tool.
8
+ - Primary controls, current result, and next action should be visible without scrolling on common viewports.
9
+ - Avoid decorative wrappers around the actual work surface.
10
+
11
+ ## Required States
12
+
13
+ - Ready, dirty, validating, loading, empty, error, disabled, success, export-ready, and mobile states.
14
+ - Keyboard access for repeated actions.
15
+ - Clear undo, reset, save, copy, download, and share behavior where relevant.
16
+
17
+ ## Design Direction
18
+
19
+ - Favor stable dimensions, direct manipulation, compact controls, and strong feedback.
20
+ - Use icons for repeated tool actions when a familiar icon exists.
21
+ - Tokens must cover control size, focus rings, surface contrast, and responsive constraints.
@@ -0,0 +1,2 @@
1
+
2
+ export { }