fix: rename the Projects org settings URL to /settings/projects

The org settings page at /orgs/:organizationSlug/settings/runtime-updates was
rebuilt into a general "Projects" page, but its URL still described only the
runtime-update banner at the top of it. Move the page to
/orgs/:organizationSlug/settings/projects and rename the path helper and page
component to match.

The old URL keeps working: a redirect-only loader at the old segment sends
requests to the new path, preserving the org slug and any query string. The
`/_/` deeplink table gains a `projects` key and keeps `runtime-updates` as an
alias for the same page, so links already shared under either name resolve.

Names that describe the runtime-update feature rather than the URL
(projectRuntimeUpdates.server, organizationHasProjectRuntimeUpdate,
ProjectRuntimeRow) are left alone, since they are still accurate.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: claude

apps/webapp/app/components/navigation/OrganizationSettingsSideMenu.tsx

@@ -16,8 +16,8 @@ import { type MatchedOrganization } from "~/hooks/useOrganizations";
 import { cn } from "~/utils/cn";
 import {
   organizationPath,
+  organizationProjectsPath,
   organizationRolesPath,
-  organizationRuntimeUpdatesPath,
   organizationSettingsPath,
   organizationSlackIntegrationPath,
   organizationSsoPath,
@@ -136,8 +136,8 @@ export function OrganizationSettingsSideMenu({
             icon={FolderOpenIcon}
             activeIconColor="text-text-bright"
             inactiveIconColor="text-text-dimmed"
-            to={organizationRuntimeUpdatesPath(organization)}
-            data-action="runtime-updates"
+            to={organizationProjectsPath(organization)}
+            data-action="projects"
             badge={
               hasProjectRuntimeUpdate ? (
                 <>

apps/webapp/app/routes/[_].$.ts

@@ -12,7 +12,7 @@ import {
   invitesPath,
   newOrganizationPath,
   newProjectPath,
-  organizationRuntimeUpdatesPath,
+  organizationProjectsPath,
   v3EnvironmentPath,
 } from "~/utils/pathBuilder";
 
@@ -33,8 +33,8 @@ export const loader = async ({ request }: LoaderFunctionArgs) => {
   const presenter = new SelectBestEnvironmentPresenter();
   try {
     const { project, organization, environment } = await presenter.call({ user });
-    if (organizationPage === "runtime-updates") {
-      return redirect(`${organizationRuntimeUpdatesPath(organization)}${search}`);
+    if (organizationPage === "projects") {
+      return redirect(`${organizationProjectsPath(organization)}${search}`);
     }
 
     const environmentPath = v3EnvironmentPath(organization, project, environment);
@@ -57,8 +57,8 @@ export const loader = async ({ request }: LoaderFunctionArgs) => {
     });
 
     if (organization) {
-      if (organizationPage === "runtime-updates") {
-        return redirect(`${organizationRuntimeUpdatesPath(organization)}${search}`);
+      if (organizationPage === "projects") {
+        return redirect(`${organizationProjectsPath(organization)}${search}`);
       }
 
       return redirect(newProjectPath(organization));

…s.runtime-updates/RuntimeUpdatesPage.tsx …nSlug.settings.projects/ProjectsPage.tsxapps/webapp/app/routes/_app.orgs.$organizationSlug.settings.runtime-updates/RuntimeUpdatesPage.tsx renamed to apps/webapp/app/routes/_app.orgs.$organizationSlug.settings.projects/ProjectsPage.tsx apps/webapp/app/routes/_app.orgs.$organizationSlug.settings.runtime-updates/RuntimeUpdatesPage.tsx renamed to apps/webapp/app/routes/_app.orgs.$organizationSlug.settings.projects/ProjectsPage.tsx

@@ -42,7 +42,7 @@ export type ProjectRuntimeRow = {
   } | null;
 };
 
-export function RuntimeUpdatesPage({
+export function ProjectsPage({
   organizationSlug,
   needsUpdate,
   otherProjects,

…nSlug.settings.runtime-updates/route.tsx …nizationSlug.settings.projects/route.tsxapps/webapp/app/routes/_app.orgs.$organizationSlug.settings.runtime-updates/route.tsx renamed to apps/webapp/app/routes/_app.orgs.$organizationSlug.settings.projects/route.tsx apps/webapp/app/routes/_app.orgs.$organizationSlug.settings.runtime-updates/route.tsx renamed to apps/webapp/app/routes/_app.orgs.$organizationSlug.settings.projects/route.tsx

@@ -6,7 +6,7 @@ import { dashboardLoader } from "~/services/routeBuilders/dashboardBuilder";
 import { getUserId } from "~/services/session.server";
 import { pageMeta } from "~/utils/pageTitle";
 import { OrganizationParamsSchema } from "~/utils/pathBuilder";
-import { type ProjectRuntimeRow, RuntimeUpdatesPage } from "./RuntimeUpdatesPage";
+import { type ProjectRuntimeRow, ProjectsPage } from "./ProjectsPage";
 
 export const meta = pageMeta("Projects");
 
@@ -73,7 +73,7 @@ export default function Page() {
   const { organizationSlug, needsUpdate, otherProjects } = useTypedLoaderData<typeof loader>();
 
   return (
-    <RuntimeUpdatesPage
+    <ProjectsPage
       organizationSlug={organizationSlug}
       needsUpdate={needsUpdate}
       otherProjects={otherProjects}

apps/webapp/app/routes/orgs.$organizationSlug.settings.runtime-updates.ts

@@ -0,0 +1,10 @@
+import { redirect, type LoaderFunctionArgs } from "@remix-run/server-runtime";
+import { OrganizationParamsSchema, organizationProjectsPath } from "~/utils/pathBuilder";
+
+// The Projects settings page used to live at `/settings/runtime-updates`. Keep the old URL working
+// for links that were already shared.
+export const loader = async ({ params, request }: LoaderFunctionArgs) => {
+  const { organizationSlug } = OrganizationParamsSchema.parse(params);
+  const { search } = new URL(request.url);
+  return redirect(`${organizationProjectsPath({ slug: organizationSlug })}${search}`);
+};

apps/webapp/app/utils/deeplinkPages.test.ts

@@ -164,11 +164,20 @@ describe("resolveDeeplinkPage", () => {
   });
 
   it("resolves organization-level pages separately from environment pages", () => {
+    expect(ORG_PAGE_TARGETS.get("projects")).toEqual({
+      landing: "projects",
+      prefix: "projects",
+    });
+    expect(resolveOrganizationDeeplinkPage("projects")).toBe("projects");
+    expect(resolveDeeplinkPage("projects")).toBeUndefined();
+  });
+
+  it("keeps the legacy runtime-updates deeplink pointing at the projects page", () => {
     expect(ORG_PAGE_TARGETS.get("runtime-updates")).toEqual({
-      landing: "runtime-updates",
-      prefix: "runtime-updates",
+      landing: "projects",
+      prefix: "projects",
     });
-    expect(resolveOrganizationDeeplinkPage("runtime-updates")).toBe("runtime-updates");
+    expect(resolveOrganizationDeeplinkPage("runtime-updates")).toBe("projects");
     expect(resolveDeeplinkPage("runtime-updates")).toBeUndefined();
   });
 

apps/webapp/app/utils/deeplinkPages.ts

@@ -39,7 +39,10 @@ export const ENV_PAGE_TARGETS: ReadonlyMap<string, DeeplinkTarget> = new Map([
 ]);
 
 export const ORG_PAGE_TARGETS: ReadonlyMap<string, DeeplinkTarget> = new Map([
-  ["runtime-updates", page("runtime-updates")],
+  ["projects", page("projects")],
+  // Alias: `/_/runtime-updates` links are already out in the wild, so keep them landing on the
+  // same page as `/_/projects`.
+  ["runtime-updates", page("projects")],
 ]);
 
 export const DEEPLINK_PATH_PREFIX = "/_";

apps/webapp/app/utils/pathBuilder.ts

@@ -170,8 +170,8 @@ export function organizationSettingsPath(organization: OrgForPath) {
   return `${organizationPath(organization)}/settings`;
 }
 
-export function organizationRuntimeUpdatesPath(organization: OrgForPath) {
-  return `${organizationSettingsPath(organization)}/runtime-updates`;
+export function organizationProjectsPath(organization: OrgForPath) {
+  return `${organizationSettingsPath(organization)}/projects`;
 }
 
 function organizationIntegrationsPath(organization: OrgForPath) {