allow share links with collapsible sidebar param

apps/api/src/v1/workspaces/workspace/documents/document/settings.ts

@@ -8,6 +8,7 @@ import { broadcastDocument } from '../../../../../websocket/workspace/documents.
 const DocumentSettings = z.object({
   runUnexecutedBlocks: z.boolean().optional(),
   runSQLSelection: z.boolean().optional(),
+  shareLinksWithoutSidebar: z.boolean().optional(),
 })
 
 export default function settingsRouter(socketServer: IOServer) {
@@ -22,13 +23,18 @@ export default function settingsRouter(socketServer: IOServer) {
       return
     }
 
-    const { runUnexecutedBlocks, runSQLSelection } = body.data
+    const { runUnexecutedBlocks, runSQLSelection, shareLinksWithoutSidebar } =
+      body.data
 
     try {
       const doc = await recoverFromNotFound(
         prisma().document.update({
           where: { id: documentId },
-          data: { runUnexecutedBlocks, runSQLSelection },
+          data: {
+            runUnexecutedBlocks,
+            runSQLSelection,
+            shareLinksWithoutSidebar,
+          },
         })
       )
       if (!doc) {

apps/web/src/components/Dashboard/index.tsx

@@ -86,12 +86,20 @@ export default function Dashboard(props: Props) {
     )
   }, [props.publish, props.publishing])
 
+  const shareLinkWithoutSidebar = props.document.shareLinksWithoutSidebar
   const copyLink = useMemo(
     () =>
       `${NEXT_PUBLIC_PUBLIC_URL()}/workspaces/${
         props.document.workspaceId
-      }/documents/${props.document.id}`,
-    [router]
+      }/documents/${props.document.id}/dashboard${
+        props.isEditing ? '/edit' : ''
+      }${shareLinkWithoutSidebar ? '?sidebarCollapsed=true' : ''}`,
+    [
+      props.document.workspaceId,
+      props.document.id,
+      props.isEditing,
+      shareLinkWithoutSidebar,
+    ]
   )
 
   const documentTitle = useMemo(

apps/web/src/components/PageSettingsPanel.tsx

@@ -61,6 +61,12 @@ export default function PageSettingsPanel(props: Props) {
               enabled={document?.runSQLSelection ?? false}
               onToggle={api.toggleRunSQLSelection}
             />
+            <PageSettingToggle
+              name="Share links without sidebar"
+              description="Whether the 'copy link' button should include a query parameter to hide the sidebar (open dashboards with the sidebar collapsed)."
+              enabled={document?.shareLinksWithoutSidebar ?? false}
+              onToggle={api.toggleShareLinksWithoutSidebar}
+            />
           </div>
         </div>
       </Transition>

apps/web/src/components/PrivateDocumentPage.tsx

@@ -165,12 +165,21 @@ function PrivateDocumentPageInner(
   }, [setSelectedSidebar])
 
   const router = useRouter()
+  const shareLinkWithoutSidebar = props.document.shareLinksWithoutSidebar
   const copyLink = useMemo(
     () =>
       `${NEXT_PUBLIC_PUBLIC_URL()}/workspaces/${props.workspaceId}/documents/${
         props.documentId
+      }/notebook${props.isApp ? '' : '/edit'}${
+        shareLinkWithoutSidebar ? `?sidebarCollapsed=true` : ''
       }`,
-    [router]
+    [
+      router,
+      props.workspaceId,
+      props.documentId,
+      props.isApp,
+      shareLinkWithoutSidebar,
+    ]
   )
 
   const isViewer = props.user.roles[props.workspaceId] === 'viewer'

apps/web/src/hooks/useDocument.ts

@@ -7,6 +7,7 @@ type API = {
   publish: () => Promise<void>
   toggleRunUnexecutedBlocks: () => Promise<void>
   toggleRunSQLSelection: () => Promise<void>
+  toggleShareLinksWithoutSidebar: () => Promise<void>
 }
 
 type UseDocument = [
@@ -76,17 +77,40 @@ function useDocument(workspaceId: string, documentId: string): UseDocument {
     api.updateDocumentSettings,
   ])
 
+  const toggleShareLinksWithoutSidebar = useCallback(async () => {
+    const newShareLinksWithoutSidebar = !document?.shareLinksWithoutSidebar
+    try {
+      await api.updateDocumentSettings(documentId, {
+        shareLinksWithoutSidebar: newShareLinksWithoutSidebar,
+      })
+    } catch (err) {
+      alert('Failed to update document settings')
+    }
+  }, [
+    workspaceId,
+    documentId,
+    document?.shareLinksWithoutSidebar,
+    api.updateDocumentSettings,
+  ])
+
   return useMemo(
     () => [
       { document, loading, publishing },
-      { setIcon, publish, toggleRunUnexecutedBlocks, toggleRunSQLSelection },
+      {
+        setIcon,
+        publish,
+        toggleRunUnexecutedBlocks,
+        toggleRunSQLSelection,
+        toggleShareLinksWithoutSidebar,
+      },
     ],
     [
       loading,
       setIcon,
       publish,
       toggleRunUnexecutedBlocks,
       toggleRunSQLSelection,
+      toggleShareLinksWithoutSidebar,
     ]
   )
 }

apps/web/src/hooks/useDocuments.tsx

@@ -75,6 +75,7 @@ function upsertDocumentInMemory(
       userAppClock: {},
       runUnexecutedBlocks: false,
       runSQLSelection: false,
+      shareLinksWithoutSidebar: true,
       hasDashboard: false,
     })
   }
@@ -207,7 +208,11 @@ type API = {
   ) => Promise<void>
   updateDocumentSettings: (
     id: string,
-    settings: { runUnexecutedBlocks?: boolean; runSQLSelection?: boolean }
+    settings: {
+      runUnexecutedBlocks?: boolean
+      runSQLSelection?: boolean
+      shareLinksWithoutSidebar?: boolean
+    }
   ) => Promise<void>
   publish: (id: string) => Promise<void>
 }

apps/web/src/hooks/useSideBar.tsx

@@ -5,6 +5,7 @@ import {
   useContext,
   useState,
 } from 'react'
+import { useStringQuery } from './useQueryArgs'
 
 type Context = [boolean, Dispatch<SetStateAction<boolean>>]
 const Context = createContext<Context>([true, () => {}] as unknown as Context)
@@ -14,7 +15,8 @@ export default function useSideBar(): Context {
 }
 
 export function SideBarProvider({ children }: { children: React.ReactNode }) {
-  const value = useState(true)
+  const noSidebarQs = useStringQuery('sidebarCollapsed')
+  const value = useState(noSidebarQs === 'true')
 
   return <Context.Provider value={value}>{children}</Context.Provider>
 }

docs/settings/page-settings.mdx

@@ -25,3 +25,13 @@ When you run a SQL block, Briefer will run its entire content by default.
 If you only want to run a specific part of the SQL block, you need to enable the "Run selected SQL only" switch.
 
 After enabling this setting, Briefer will only run the SQL code you've selected. If you haven't selected any code, Briefer will run the entire block.
+
+## Share links without sidebar
+
+By default, clicking the "copy link" element within the "Share" menu will copy a link that opens the page with the sidebar _collapsed_.
+
+If you want to share a link that opens the page with the sidebar _expanded_, you can disable the "Share links without sidebar" switch.
+
+<Note>
+  The query parameter which controls the sidebar state is `sidebarCollapsed`. You can also manually set it to `true` or `false` to control the sidebar state.
+</Note>

packages/database/prisma/migrations/20250104200947_share_links_without_sidebar/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "Document" ADD COLUMN     "shareLinksWithoutSidebar" BOOLEAN NOT NULL DEFAULT true;

packages/database/prisma/schema.prisma

@@ -29,16 +29,17 @@ model Document {
   parent      Document?  @relation("DocumentParent", fields: [parentId], references: [id], onDelete: Cascade)
   children    Document[] @relation("DocumentParent")
 
-  yjsDocument        YjsDocument?
-  yjsAppDocuments    YjsAppDocument[]
-  comments           Comment[]
-  Favorite           Favorite[]
-  executionSchedules ExecutionSchedule[]
-  reusableComponents ReusableComponent[]
+  yjsDocument                YjsDocument?
+  yjsAppDocuments            YjsAppDocument[]
+  comments                   Comment[]
+  Favorite                   Favorite[]
+  executionSchedules         ExecutionSchedule[]
+  reusableComponents         ReusableComponent[]
   reusableComponentInstances ReusableComponentInstance[]
 
-  runUnexecutedBlocks Boolean @default(false)
-  runSQLSelection     Boolean @default(false)
+  runUnexecutedBlocks      Boolean @default(false)
+  runSQLSelection          Boolean @default(false)
+  shareLinksWithoutSidebar Boolean @default(false)
 }
 
 model YjsDocument {