stack/packages/stack-shared/src
BilalG1 d1751a7634
fix(init-prompt): require StackProvider for all frameworks (#1374)
## Summary
- The init prompt marked the `StackProvider` step as *React only* and
placed it after the `StackHandler` step. Following it on a Next.js
project produced a layout with no provider, so `StackHandler` crashed at
runtime with `useStackApp must be used within a StackProvider`.
- Make the provider step unconditional and move it ahead of the handler
step so the dependency order matches the instruction order. Also quote
the exact error message so the model won't skip it.

## Test plan
- [ ] Run `npx @stackframe/stack-cli init` (or the web flow) against a
fresh Next.js app and confirm `/handler/[...stack]` renders without the
`useStackApp` error.
- [ ] Re-run against a Vite/React app to confirm the reordered
instructions still produce a working setup.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Added explicit global MCP config file path guidance for several coding
agents.
* Documented required provider configuration across supported
frameworks.
* Clarified where to place provider wrappers in root app layouts
(including Next.js app/layout).
* Reordered setup steps to surface the required "Wrap your app in a
Stack provider" step and updated step numbering.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-04-24 12:27:49 -07:00
..
ai Overview revamp (#1238) 2026-04-15 09:36:00 -07:00
apps Fraud Protection sub-app 2026-04-05 21:35:01 -07:00
config clickhouse new syncs and verify-data (#1304) 2026-04-08 14:43:22 -07:00
helpers fix(init-prompt): require StackProvider for all frameworks (#1374) 2026-04-24 12:27:49 -07:00
hooks Payments UX update (#863) 2025-08-27 17:28:01 -07:00
interface Payments bulldozer txn rework (#1315) 2026-04-17 22:11:21 +00:00
payments [Feat] Add payment methods page to dashboard (#1103) 2026-01-20 14:33:31 -08:00
utils More tracing for replication-related functions 2026-04-17 17:57:34 -07:00
config-authoring.test.ts make config typesafe (#1254) 2026-04-06 18:31:55 +00:00
config-authoring.ts make config typesafe (#1254) 2026-04-06 18:31:55 +00:00
config-rendering.ts make config typesafe (#1254) 2026-04-06 18:31:55 +00:00
crud.tsx Config DB (#568) 2025-04-10 19:38:25 +02:00
global.d.ts Replace required() of yup schemas with defined() 2024-11-18 20:08:55 +01:00
index.ts [docs][dashboard][stack-shared] Update docs to new apps (#996) 2025-11-12 15:45:30 -06:00
known-errors.tsx Better error message when user info fetching fails 2026-04-13 11:10:32 -07:00
plans.ts [Fix] [Refactor] Implement Base Settings for Stack-Auth Plans and Move Metadata from Stripe Webhook Event to Table (#1214) 2026-02-23 22:09:27 -08:00
schema-fields.ts [codex] Fix Neon malformed Basic auth validation (#1381) 2026-04-24 11:59:18 -07:00
sessions.ts Update AGENTS.md 2026-02-13 18:34:23 -08:00