add embedded checkout

2026-08-20 07:35:31 +01:00
parent c6e987a852
commit 397543c880
45 changed files with 5731 additions and 334 deletions
@@ -0,0 +1,48 @@
+# Canonical documentation — sources of truth for code patterns
+
+## Canonical documentation
+
+Before writing any code file, read the relevant canonical docs page using WebFetch. These docs are the source of truth for API patterns, component usage, and configuration — do NOT reproduce code examples from memory or from this skill file.
+
+If you cannot access the docs, tell the user you need them to provide the current patterns rather than guessing.
+
+## Reference pages
+
+| Topic | URL |
+| --- | --- |
+| App scaffold and workflow | https://docs.stripe.com/stripe-apps/create-app |
+| Manifest schema (`stripe-app.yaml`) | https://docs.stripe.com/stripe-apps/reference/app-manifest |
+| Permissions reference | https://docs.stripe.com/stripe-apps/reference/permissions |
+| Backend + signed requests (`fetchStripeSignature`) | https://docs.stripe.com/stripe-apps/build-backend |
+| Authentication types (platform, OAuth, RAK) | https://docs.stripe.com/stripe-apps/api-authentication |
+| Events and webhooks | https://docs.stripe.com/stripe-apps/events |
+| How UI extensions work | https://docs.stripe.com/stripe-apps/how-ui-extensions-work |
+| UI components | https://docs.stripe.com/stripe-apps/components |
+| Extensions SDK API (`createHttpClient`, Stripe client) | https://docs.stripe.com/stripe-apps/reference/extensions-sdk-api |
+| Secret Store | https://docs.stripe.com/stripe-apps/store-secrets |
+| Versioning and releases | https://docs.stripe.com/stripe-apps/versions-and-releases |
+| Marketplace submission | https://docs.stripe.com/stripe-apps/publish-app |
+| Onboarding UX patterns | https://docs.stripe.com/stripe-apps/patterns/onboarding-experience |
+| Full-page apps | https://docs.stripe.com/stripe-apps/patterns/full-page-apps |
+| Viewports reference | https://docs.stripe.com/stripe-apps/reference/viewports |
+| Sandbox support | https://docs.stripe.com/stripe-apps/enable-sandbox-support |
+
+## How to use this list
+
+1. Identify which topics are relevant to the app you’re building (based on discovery answers)
+2. WebFetch each relevant page BEFORE writing code
+3. Follow the patterns shown in the docs exactly — field names, import paths, constructor signatures
+4. If a pattern in your training data conflicts with what the docs show, the docs win
+
+## Common lookup scenarios
+
+| You need to… | Read this page |
+| --- | --- |
+| Initialize the Stripe client in a UI extension | Extensions SDK API |
+| Verify `fetchStripeSignature` on your backend | Backend + signed requests |
+| Choose between platform keys, OAuth, or restricted keys | Authentication types |
+| Set up webhooks for a public app | Events and webhooks |
+| Store secrets (OAuth tokens, API keys) | Secret Store |
+| Know which UI components are available | UI components |
+| Declare permissions in the manifest | Permissions reference |
+| Publish to the marketplace | Marketplace submission |