docs(forking): workspace forking for enterprises

apps/docs/content/docs/en/platform/enterprise/index.mdx

@@ -5,7 +5,7 @@ description: Enterprise features for business organizations
 
 import { FAQ } from '@/components/ui/faq'
 
-Sim Enterprise adds fine-grained access control, SSO, audit logging, and compliance features on top of Team plans.
+Sim Enterprise adds fine-grained access control, SSO, audit logging, compliance features, and workspace forking on top of Team plans.
 
 ---
 
@@ -65,8 +65,14 @@ Continuously export workflow logs, audit logs, and Mothership data to a customer
 
 ---
 
+## Workspace Forks
+
+Clone a workspace into a linked child, then push or pull **deployed** workflow changes between them. Deploy is like a commit; sync is a force push or force pull. See the [workspace forks guide](/platform/enterprise/forks).
+
+---
+
 <FAQ items={[
-  { question: "Who can manage Enterprise features?", answer: "Workspace admins on an Enterprise-entitled workspace. Access Control, SSO, whitelabeling, audit logs, and data retention are all configured per workspace under Settings → Enterprise." },
+  { question: "Who can manage Enterprise features?", answer: "Workspace admins on an Enterprise-entitled workspace. Access Control, SSO, whitelabeling, audit logs, data retention, data drains, and forks are all configured per workspace under Settings → Enterprise." },
   { question: "Which SSO providers are supported?", answer: "Sim supports SAML 2.0 and OIDC, which works with virtually any enterprise identity provider including Okta, Azure AD (Entra ID), Google Workspace, ADFS, and OneLogin." },
   { question: "How do access control permission groups work?", answer: "Permission groups are created per workspace and let you restrict which AI providers, workflow blocks, and platform features are available to specific members of that workspace. Each user can belong to at most one group per workspace. Users not assigned to any group have full access. Restrictions are enforced at both the UI level and at execution time based on the workflow's workspace." },
 ]} />
@@ -86,6 +92,7 @@ Self-hosted deployments enable enterprise features via environment variables ins
 | `AUDIT_LOGS_ENABLED`, `NEXT_PUBLIC_AUDIT_LOGS_ENABLED` | Audit logging |
 | `NEXT_PUBLIC_DATA_RETENTION_ENABLED` | Data retention configuration |
 | `DATA_DRAINS_ENABLED`, `NEXT_PUBLIC_DATA_DRAINS_ENABLED` | Data drains |
+| `FORKING_ENABLED`, `NEXT_PUBLIC_FORKING_ENABLED` | Workspace forking |
 | `INBOX_ENABLED`, `NEXT_PUBLIC_INBOX_ENABLED` | Sim Mailer inbox |
 | `DISABLE_INVITATIONS`, `NEXT_PUBLIC_DISABLE_INVITATIONS` | Disable invitations; manage membership via Admin API |
 

apps/docs/content/docs/en/platform/enterprise/meta.json

@@ -8,7 +8,8 @@
     "whitelabeling",
     "audit-logs",
     "data-retention",
-    "data-drains"
+    "data-drains",
+    "forks"
   ],
   "defaultOpen": false
 }

apps/sim/app/workspace/[workspaceId]/settings/[section]/page.tsx

@@ -32,7 +32,7 @@ const SECTION_TITLES: Record<string, string> = {
   sso: 'Single Sign-On',
   whitelabeling: 'Whitelabeling',
   copilot: 'Chat Keys',
-  forks: 'Forks',
+  forks: 'Workspace Forks',
   mcp: 'MCP Tools',
   'custom-tools': 'Custom Tools',
   'workflow-mcp-servers': 'MCP Servers',

apps/sim/app/workspace/[workspaceId]/settings/navigation.ts

@@ -139,10 +139,11 @@ export const allNavigationItems: NavigationItem[] = [
   },
   {
     id: 'forks',
-    label: 'Forks',
+    label: 'Workspace Forks',
     description: 'Fork this workspace and sync changes with its parent.',
     icon: Shuffle,
     section: 'enterprise',
+    docsLink: 'https://docs.sim.ai/platform/enterprise/forks',
   },
   {
     id: 'billing',

apps/sim/ee/workspace-forking/components/forks.tsx

@@ -157,7 +157,7 @@ function ForkSyncDetailView({
     <>
       <SettingsPanel
         back={{
-          text: 'Forks',
+          text: 'Workspace Forks',
           icon: ArrowLeft,
           onSelect: () =>
             guard.guardBack(() => {
@@ -249,7 +249,7 @@ function ForkActivityDetailView({
 }: ForkActivityDetailViewProps) {
   return (
     <SettingsPanel
-      back={{ text: 'Forks', icon: ArrowLeft, onSelect: onBack }}
+      back={{ text: 'Workspace Forks', icon: ArrowLeft, onSelect: onBack }}
       title='Activity'
       actions={actions}
     >

apps/sim/lib/compare/data/feature-catalog.ts

@@ -417,19 +417,9 @@ export const SIM_FEATURES: SimFeature[] = [
       'This is a genuine git-like fork/diff/promote/rollback system scoped to an entire workspace, not a single-workflow versioning feature. Most workflow-automation competitors only version individual workflows, not whole environments with cross-environment resource remapping.',
     sources: [
       {
-        url: 'https://github.com/simstudioai/sim/blob/main/packages/db/schema.ts',
-        label: 'Sim codebase: workspaceForkResourceMap / workspaceForkPromoteRun tables',
-        asOf: '2026-07-02',
-      },
-      {
-        url: 'https://github.com/simstudioai/sim/blob/main/apps/sim/ee/workspace-forking/lib/promote/promote.ts',
-        label: 'Sim codebase: fork promote engine',
-        asOf: '2026-07-02',
-      },
-      {
-        url: 'https://github.com/simstudioai/sim/blob/main/apps/sim/app/api/workspaces/[id]/fork/route.ts',
-        label: 'Sim codebase: fork creation API',
-        asOf: '2026-07-02',
+        url: 'https://docs.sim.ai/platform/enterprise/forks',
+        label: 'Sim Docs: Workspace Forks',
+        asOf: '2026-07-08',
       },
     ],
   },
@@ -444,19 +434,9 @@ export const SIM_FEATURES: SimFeature[] = [
       'Treating credentials/env-vars as required-and-blocking on promote (rather than silently copying secrets) is a specific, auditable safety design for enterprise dev→qa→prod pipelines.',
     sources: [
       {
-        url: 'https://github.com/simstudioai/sim/blob/main/apps/sim/ee/workspace-forking/lib/create-fork.ts',
-        label: 'Sim codebase: fork creation (credentials cleared)',
-        asOf: '2026-07-02',
-      },
-      {
-        url: 'https://github.com/simstudioai/sim/blob/main/apps/sim/ee/workspace-forking/lib/remap/remap-references.ts',
-        label: 'Sim codebase: required-kinds remap/block logic',
-        asOf: '2026-07-02',
-      },
-      {
-        url: 'https://github.com/simstudioai/sim/blob/main/apps/sim/app/api/workspaces/[id]/fork/mapping/route.ts',
-        label: 'Sim codebase: fork credential mapping API',
-        asOf: '2026-07-02',
+        url: 'https://docs.sim.ai/platform/enterprise/forks',
+        label: 'Sim Docs: Workspace Forks (mappings)',
+        asOf: '2026-07-08',
       },
     ],
   },
@@ -469,9 +449,9 @@ export const SIM_FEATURES: SimFeature[] = [
       'Forking/promotion is gated on the billed account having Enterprise-tier access on hosted Sim, mirroring the same access-gate pattern used for SSO. Self-hosted deployments can enable it independent of billing via a FORKING_ENABLED/NEXT_PUBLIC_FORKING_ENABLED environment flag.',
     sources: [
       {
-        url: 'https://github.com/simstudioai/sim/blob/main/apps/sim/ee/workspace-forking/lib/lineage/authz.ts',
-        label: 'Sim codebase: assertForkingEnabled / assertCanFork',
-        asOf: '2026-07-02',
+        url: 'https://docs.sim.ai/platform/enterprise/forks',
+        label: 'Sim Docs: Workspace Forks (self-hosted setup)',
+        asOf: '2026-07-08',
       },
     ],
   },

apps/sim/lib/compare/data/sim.ts

@@ -57,9 +57,9 @@ export const simProfile: CompetitorProfile = {
         'Fork a whole workspace into a dev/qa/prod-style child environment, preview a diff, and promote changes bidirectionally. Credential and env-var remapping is required on every promote, so secrets never cross environments silently.',
       shortDescription: 'Fork, diff, and promote environments with mandatory credential remapping.',
       source: {
-        url: 'https://github.com/simstudioai/sim/blob/main/apps/sim/ee/workspace-forking/lib/promote/promote.ts',
-        label: 'Sim codebase: fork promote engine',
-        asOf: '2026-07-02',
+        url: 'https://docs.sim.ai/platform/enterprise/forks',
+        label: 'Sim Docs: Workspace Forks',
+        asOf: '2026-07-08',
       },
     },
     {
@@ -222,14 +222,9 @@ export const simProfile: CompetitorProfile = {
         confidence: 'verified',
         sources: [
           {
-            url: 'https://github.com/simstudioai/sim/blob/main/packages/db/schema.ts',
-            label: 'Sim codebase: workspaceForkResourceMap / workspaceForkPromoteRun',
-            asOf: '2026-07-02',
-          },
-          {
-            url: 'https://github.com/simstudioai/sim/blob/main/apps/sim/ee/workspace-forking/lib/promote/promote.ts',
-            label: 'Sim codebase: fork promote engine',
-            asOf: '2026-07-02',
+            url: 'https://docs.sim.ai/platform/enterprise/forks',
+            label: 'Sim Docs: Workspace Forks',
+            asOf: '2026-07-08',
           },
         ],
       },