package.json (1)

69-69:Use the samenpx --package=tsx pattern for consistency across scripts.

Other TSX-backed scripts (lines 8 & 64) explicitly pin the runtime package to avoid relying on a globally-installed binary. Keeping the pattern uniform reduces surprises in fresh clone / CI environments.

-    "changelog:update": "npx tsx scripts/interactive-changelog.ts"+    "changelog:update": "npx --package=tsx tsx scripts/interactive-changelog.ts"

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

apps/backend/src/lib/projects.tsx (1)

79-126:Transaction boundary change may impact atomicity

Moving config override operations outside the transaction means project creation/update and config overrides are no longer atomic. If config overrides fail, the project will be in an inconsistent state.

Consider wrapping all operations in a single transaction or implementing compensating transactions:

+  // Consider implementing a saga pattern or compensating transaction+  let projectCreated = false;+  try {     const [projectId, branchId] = await retryTransaction(globalPrismaClient, async (tx) => {       // ... existing transaction logic ...     });+    projectCreated = true;      // Update project config override     await overrideProjectConfigOverride({       // ... existing logic ...     });          // Update environment config override     // ... existing logic ...+  } catch (error) {+    if (projectCreated && options.type === "create") {+      // Rollback: delete the created project+      await globalPrismaClient.project.delete({ where: { id: projectId } });+    }+    throw error;+  }

apps/backend/src/app/api/latest/integrations/custom/domains/crud.tsx (2)

49-51:Add null safety check for domain parameter

Same issue as in the Neon integration - the helper function should validate the domain parameter.

 function domainConfigToLegacyConfig(domain: Tenancy['config']['domains']['trustedDomains'][string]) {+  if (!domain) {+    throwErr('Domain configuration is required');+  }   return { domain: domain.baseUrl || throwErr('Domain base URL is required'), handler_path: domain.handlerPath }; }

---

63-63:Inconsistent handler path assignment

Same issue as in the Neon integration - hardcoded handler_path value.

Consider using a consistent approach:

-          domains: [...Object.values(oldDomains).map(domainConfigToLegacyConfig), { domain: data.domain, handler_path: "/handler" }],+          domains: [...Object.values(oldDomains).map(domainConfigToLegacyConfig), { domain: data.domain, handler_path: data.handler_path || "/handler" }],

CLAUDE.md (2)

7-17:Add the newchangelog:update script to "Essential Commands".
The PR introduces an interactive changelog script exposed viapnpm changelog:update, but the command is not documented here. Adding it keeps this reference file in sync with the tooling shipped in the same PR.

   - **Type check**: `pnpm typecheck`+  - **Update changelog**: `pnpm changelog:update` (runs the interactive changelog updater)

---

14-21:Remove (or consolidate) the duplicated test-command section.
Lines 18-21 repeat the test commands already documented in lines 14-15, bloating the doc without adding new information. Either delete the second block or expand it with advanced options (e.g., coverage, watch mode) to justify a separate “Testing” section.

-### Testing-- **Run all tests**: `pnpm test --no-watch`-- **Run some tests**: `pnpm test --no-watch <file-filters>`+<!-- (section removed – commands already covered above) -->

apps/dashboard/src/components/vibe-coding/dts/util-dts.ts (1)

4-4:Consider using a more maintainable approach for large type definitions

Instead of embedding the entire module declaration as a string literal, consider:

• Loading it from a separate.d.ts file at runtime
• Using a build process to inject the content
• Storing it as a separate asset file

This would make the code more maintainable and easier to update.

apps/dashboard/package.json (2)

3-3:Ensure workspace version consistency

Bumping the dashboard only to2.8.26 may desynchronise semver across other workspace packages if they track the same minor stream.
Confirm that all packages that must stay in lock-step received a matching bump (or that the version field is intentionally independent).

---

40-42:Evaluatejose impact on client bundle size

jose (~100 KB min-gz) will be shipped to the browser unless every import is server-only.
If JWT signing/verification is required only during API calls (Node runtime), gate the import with dynamicimport() insidegetServerSideProps/API routes or move the code to the backend package to avoid inflating the Next.js client bundle.

Example pattern:

- import { jwtVerify } from 'jose'+ const { jwtVerify } = await import('jose')   // inside an async server function

apps/backend/.env.development (1)

51-56:Consider reordering environment variables for consistency.

The S3 configuration variables are correctly configured for local development with s3mock. However, consider reordering them alphabetically to follow dotenv conventions.

Apply this diff to improve variable ordering:

 # S3 Configuration for local development using s3mock-STACK_S3_ENDPOINT=http://localhost:8121-STACK_S3_REGION=us-east-1-STACK_S3_ACCESS_KEY_ID=s3mockroot-STACK_S3_SECRET_ACCESS_KEY=s3mockroot-STACK_S3_BUCKET=stack-storage+STACK_S3_ACCESS_KEY_ID=s3mockroot+STACK_S3_BUCKET=stack-storage+STACK_S3_ENDPOINT=http://localhost:8121+STACK_S3_REGION=us-east-1+STACK_S3_SECRET_ACCESS_KEY=s3mockroot

apps/backend/scripts/verify-data-integrity.ts (1)

135-137:Consider more robust filtering criteria

The current implementation uses a simple substring match which works but might be fragile. Consider if a more specific pattern or field-based approach would be more reliable for identifying Neon projects.

Current implementation:

if(shouldSkipNeon&&projects[i].description.includes("Neon")){return;}

Alternative approach using a more specific pattern:

if(shouldSkipNeon&&projects[i].description?.toLowerCase().includes("neon")){console.log(`Skipping Neon project:${projects[i].displayName}`);return;}

apps/backend/src/app/api/latest/internal/email-themes/[id]/route.tsx (1)

3-3:Remove unused import.

TheglobalPrismaClient import is no longer used since the transaction parameter was removed from theoverrideEnvironmentConfigOverride call.

-import { globalPrismaClient } from "@/prisma-client";

apps/backend/.env (1)

53-59:Fix environment variable formatting issues.

The new S3 environment variables are essential for the image upload functionality. However, there are formatting inconsistencies that should be addressed:

 # S3-STACK_S3_ENDPOINT=# S3 endpoint URL (e.g., 'https://s3.amazonaws.com' for AWS or custom endpoint for S3-compatible services)-STACK_S3_REGION=+STACK_S3_ACCESS_KEY_ID=+STACK_S3_BUCKET=+STACK_S3_ENDPOINT="# S3 endpoint URL (e.g., 'https://s3.amazonaws.com' for AWS or custom endpoint for S3-compatible services)"+STACK_S3_REGION= STACK_S3_ACCESS_KEY_ID= STACK_S3_SECRET_ACCESS_KEY=-STACK_S3_BUCKET=-+STACK_S3_BUCKET=

This addresses:

• Adding quotes around the endpoint comment value
• Reordering keys alphabetically
• Removing the extra blank line

apps/backend/src/app/api/latest/teams/crud.tsx (1)

84-84:LGTM! S3 image upload properly integrated.

The image upload functionality is correctly implemented with proper categorization ("team-profile-images") and validation. The await calls within transactions ensure data consistency.

Consider whether the S3 upload should happen outside the database transaction to reduce transaction duration, though the current approach ensures better consistency if uploads fail.

Also applies to: 168-168

apps/backend/src/app/api/latest/emails/render-email/route.tsx (1)

44-49:Consider simplifying template lookup.

The Map creation is unnecessary overhead. You can directly access the templates object.

-    if (body.theme_id && !(body.theme_id in tenancy.config.emails.themes)) {-      throw new StatusError(400, "No theme found with given id");-    }-    const templateList = new Map(Object.entries(tenancy.config.emails.templates));-    const themeSource = body.theme_id === undefined ? body.theme_tsx_source! : getEmailThemeForTemplate(tenancy, body.theme_id);-    const templateSource = body.template_id ? templateList.get(body.template_id)?.tsxSource : body.template_tsx_source;+    if (body.theme_id && !(body.theme_id in tenancy.config.emails.themes)) {+      throw new StatusError(400, "No theme found with given id");+    }+    const themeSource = body.theme_id === undefined ? body.theme_tsx_source! : getEmailThemeForTemplate(tenancy, body.theme_id);+    const templateSource = body.template_id ? tenancy.config.emails.templates[body.template_id]?.tsxSource : body.template_tsx_source;

apps/backend/src/lib/redirect-urls.tsx (1)

14-18:Domain validation logic looks correct.

The check fordomain.baseUrl before proceeding prevents potential errors. Consider logging domains without baseUrl for debugging purposes.

     if (!domain.baseUrl) {+      // Log for debugging - domain entry exists but has no baseUrl       return false;     }

apps/backend/src/app/api/latest/internal/config/override/crud.tsx (1)

12-21:Enhance JSON parsing error handling.

While catchingSyntaxError is good, consider handling other potential JSON parsing errors and providing more descriptive error messages.

       let parsedConfig;       try {         parsedConfig = JSON.parse(data.config_override_string);       } catch (e) {-        if (e instanceof SyntaxError) {-          throw new StatusError(StatusError.BadRequest, 'Invalid config JSON');-        }-        throw e;+        if (e instanceof SyntaxError) {+          throw new StatusError(StatusError.BadRequest, `Invalid config JSON: ${e.message}`);+        } else if (e instanceof TypeError) {+          throw new StatusError(StatusError.BadRequest, 'Invalid config JSON: Circular reference detected');+        }+        throw new StatusError(StatusError.BadRequest, 'Failed to parse config JSON');       }

apps/backend/prisma/seed.ts (1)

74-77:Consider improving error context in domain mapping.

While the domain mapping logic is correct, the error thrown for missing baseUrl could provide more context.

-            .map((d) => ({ domain: d.baseUrl || throwErr('Domain base URL is required'), handler_path: d.handlerPath })),+            .map((d) => ({+              domain: d.baseUrl || throwErr(`Domain base URL is required for trusted domain entry`),+              handler_path: d.handlerPath+            })),

apps/dashboard/src/app/(main)/integrations/featurebase/sso/page.tsx (1)

44-48:Consider making the Featurebase URL configurable.

The Featurebase URL is hardcoded, which might cause issues in different environments (development, staging, production).

Consider making it configurable:

+const featurebaseUrl = getEnvVariable("STACK_FEATUREBASE_URL", "https://feedback.stack-auth.com");+ // Redirect to Featurebase with JWT and return_to-const featurebaseUrl = new URL("https://feedback.stack-auth.com/api/v1/auth/access/jwt");+const featurebaseUrl = new URL(`${featurebaseUrl}/api/v1/auth/access/jwt`);

apps/backend/src/lib/images.tsx (1)

44-45:Avoid using 'any' type for better type safety.

Using proper types from the sharp library would improve type safety and IDE support.

Import and use proper types:

-  let sharpImage: any;-  let metadata: any;+  let sharpImage: ReturnType<typeof sharp>;+  let metadata: Awaited<ReturnType<ReturnType<typeof sharp>['metadata']>>;

apps/backend/src/lib/email-rendering.tsx (1)

75-75:Improved subject extraction from template.

Good improvement to extract actual Subject component from template. Consider enhancing the regex to also match non-self-closing Subject tags.

The current regex only matches self-closing tags. Consider supporting both formats:

-      subject: `Mock subject, ${templateComponent.match(/<Subject\s+[^>]*\/>/g)?.[0]}`,+      subject: `Mock subject, ${templateComponent.match(/<Subject\s+[^>]*(?:\/?>|>.*?<\/Subject>)/g)?.[0]}`,

apps/backend/src/app/api/latest/integrations/custom/domains/crud.tsx (1)

49-90:Consider extracting shared domain CRUD logic

This file shares identical logic withapps/backend/src/app/api/latest/integrations/neon/domains/crud.tsx. Consider extracting the common domain CRUD handlers and helper functions into a shared module to reduce code duplication and maintain consistency.

Create a shared module atapps/backend/src/app/api/latest/integrations/shared/domains.tsx to house the common logic.

apps/backend/src/app/api/latest/integrations/neon/oauth-providers/crud.tsx (1)

83-89:Inefficient provider lookup in findLegacyProvider

The current implementation usesObject.entries andfind which creates unnecessary intermediate arrays. Consider using a more efficient approach.

-function findLegacyProvider(tenancy: Tenancy, providerType: string) {-  const providerRaw = Object.entries(tenancy.config.auth.oauth.providers).find(([_, provider]) => provider.type === providerType);-  if (!providerRaw) {-    return null;-  }-  return oauthProviderConfigToLegacyConfig(providerRaw[1]);-}+function findLegacyProvider(tenancy: Tenancy, providerType: string) {+  for (const provider of Object.values(tenancy.config.auth.oauth.providers)) {+    if (provider.type === providerType) {+      return oauthProviderConfigToLegacyConfig(provider);+    }+  }+  return null;+}

apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/email-templates/[templateId]/page-client.tsx (1)

42-42:updateEmailTemplate parameter handling could be clearer

The ternary operator for the third parameter makes the code less readable. Consider using a more explicit approach.

-      await stackAdminApp.updateEmailTemplate(props.templateId, currentCode, selectedThemeId === undefined ? null : selectedThemeId);+      const themeId = selectedThemeId === undefined ? null : selectedThemeId;+      await stackAdminApp.updateEmailTemplate(props.templateId, currentCode, themeId);

apps/backend/src/lib/emails.tsx (1)

81-93:Email verification retry logic could benefit from jitter

The exponential backoff for Emailable API retries uses a fixed base, which could cause thundering herd issues if multiple requests retry simultaneously.

-          }, 4, { exponentialDelayBase: 4000 });+          }, 4, {+            exponentialDelayBase: 4000,+            // Add jitter to prevent thundering herd+            jitter: () => Math.random() * 1000+          });

apps/backend/src/lib/config.tsx (1)

419-433:Test snapshot makes assertions fragile

Using inline snapshots for error messages makes tests brittle to formatting changes.

Consider using more flexible assertions:

-  expect(await validateConfigOverrideSchema(unionSchema, { a: { "time": "now" } }, { "a.morning": true })).toMatchInlineSnapshot(`-    {-      "error": "[WARNING] a is not matched by any of the provided schemas:-      Schema 0:-        a must be a \`string\` type, but the final value was: \`{-          "time": "\\"now\\"",-          "morning": "true"-        }\`.-      Schema 1:-        a contains unknown properties: morning-      Schema 2:-        a.time must be one of the following values: tomorrow",-      "status": "error",-    }-  `);+  const result = await validateConfigOverrideSchema(unionSchema, { a: { "time": "now" } }, { "a.morning": true });+  expect(result.status).toBe("error");+  expect(result.error).toContain("[WARNING] a is not matched by any of the provided schemas");+  expect(result.error).toContain("morning");+  expect(result.error).toContain("tomorrow");

apps/e2e/tests/backend/endpoints/api/v1/auth/password/send-reset-code.test.ts (1)

27-42:Update password reset e2e test to use dynamic mock subject format
Replace the static subject assertions in apps/e2e/tests/backend/endpoints/api/v1/auth/password/send-reset-code.test.ts (lines 27 & 35) with the dynamic mock pattern used elsewhere, for example:

"Mock subject, <Subject value={\`Verify your email at \${project.displayName}\`} />"

and

"Mock subject, <Subject value={\`Reset your password at \${project.displayName}\`} />"

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

CHANGELOG.md (1)

30-30:Previous hyphenation issues resolved.

“platform-aware” (Line 30) and “full-screen” (Line 43) are now correctly hyphenated. Nice.

Also applies to: 43-43

CHANGELOG.md (4)

7-7:Add release date for 2.8.44.

Include the release date to improve traceability (ISO-8601). Example:

-## 2.8.44+## 2.8.44 — 2025-07-25

Please confirm the correct date before applying.

---

5-5:Enhance the NOTE with direct links to history.

Add links to tags or a compare range so readers can quickly find earlier releases removed in this consolidation.

-> NOTE: Releases before ***2.8.44*** were never documented in this file. Check git history or individual commits if you need earlier details.+> NOTE: Releases before ***2.8.44*** were not documented here. See Git tags/releases or compare views for earlier history.

Optionally add specific links to your repo’s Releases and Tags pages.

---

13-14:Unify tense and code-format identifiers/HTTP codes; capitalize “Apps” consistently.

• Use past tense consistently within a released version.
• Wrap identifiers and HTTP codes in backticks.
• Capitalize “Apps” when referring to the product feature.

Apply:

- Reworked apps config and URL helpers to support the new dashboard Apps experience- Tightened client retry logic around 429 responses for more resilient rate limiting+ Reworked Apps config and URL helpers to support the new dashboard Apps experience+ Tightened client retry logic around `429` responses for more resilient rate limiting- Checks Stripe connected accounts for charges_enabled before issuing purchase flows- Added dev-only 429 simulation plus smarter retry metadata to exercise rate-limit handling+ Checked Stripe connected accounts for `charges_enabled` before issuing purchase flows+ Added dev-only `429` simulation plus smarter retry metadata to exercise rate-limit handling- Removed runtime StackProvider fetching to make the dashboard static and simplify Suspense boundaries+ Removed runtime `StackProvider` fetching to make the dashboard static and simplify Suspense boundaries- Generates server Stack apps that inherit from the client instance when both are scaffolded+ Generated server Stack apps that inherit from the client instance when both are scaffolded- StackProvider now skips runtime user fetching so dashboard templates render statically- Stack app templates wire inheritFrom between client and server apps and update convex docs+ Made `StackProvider` skip runtime user fetching so dashboard templates render statically+ Stack app templates wired `inheritFrom` between client and server apps and updated Convex docs

Also applies to: 18-20, 24-24, 39-39, 48-49

---

26-26:Clarify list with commas and singularize “payments.”

- Surfac ed project access summaries pending invitations and clearer payments warnings across settings+ Surfaced project access summaries, pending invitations, and clearer payment warnings across settings

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro