chore: update layout and contents

Author: adithyaakrishna

apps/docs/components/ai/page-actions.tsx

@@ -2,11 +2,21 @@
 
 import { type ReactNode, useEffect, useState } from 'react'
 import type { Folder, Item, Separator } from 'fumadocs-core/page-tree'
-import { ChevronRight } from 'lucide-react'
+import { BookOpen, ChevronRight, Cog, Layers, Play, Plug, Rocket, Search } from 'lucide-react'
 import Link from 'next/link'
 import { usePathname } from 'next/navigation'
 import { cn } from '@/lib/utils'
 
+const SEPARATOR_ICONS: Record<string, React.ElementType> = {
+  Basics: BookOpen,
+  'Core Concepts': Layers,
+  Integrations: Plug,
+  'Security & Configuration': Cog,
+  'Execution & Operations': Play,
+  Deployment: Rocket,
+  Reference: Search,
+}
+
 const LANG_PREFIXES = ['/en', '/es', '/fr', '/de', '/ja', '/zh']
 
 function stripLangPrefix(path: string): string {
@@ -191,13 +201,18 @@ export function SidebarFolder({ item, children }: { item: Folder; children: Reac
 }
 
 export function SidebarSeparator({ item }: { item: Separator }) {
+  const name = typeof item.name === 'string' ? item.name : ''
+  const Icon = SEPARATOR_ICONS[name]
+
   return (
     <p
       className={cn(
-        'mt-4 mb-2 px-2 font-medium text-fd-muted-foreground text-xs',
-        'lg:mt-5 lg:mb-1.5 lg:px-2.5 lg:font-semibold lg:text-[10.5px] lg:text-neutral-400 lg:uppercase lg:tracking-widest lg:dark:text-neutral-500'
+        'mt-5 mb-2 flex items-center gap-2 px-2 font-semibold text-fd-muted-foreground text-sm',
+        'lg:mt-7 lg:mb-2 lg:px-2.5 lg:text-[13px] lg:font-[620] lg:tracking-normal lg:text-neutral-800 lg:dark:text-neutral-200',
+        'first:lg:mt-0 first:mt-0'
       )}
     >
+      {Icon && <Icon className='h-[14px] w-[14px] flex-shrink-0 opacity-70' />}
       {item.name}
     </p>
   )

apps/docs/components/docs-layout/sidebar-components.tsx

@@ -1,4 +1,3 @@
-import { ArrowRight, ChevronRight } from 'lucide-react'
 import Link from 'next/link'
 
 export function TOCFooter() {
@@ -18,20 +17,10 @@ export function TOCFooter() {
           href='https://sim.ai/signup'
           target='_blank'
           rel='noopener noreferrer'
-          className='group mt-2 inline-flex h-[32px] w-fit items-center rounded-[5px] bg-[#33c482] px-[10px] font-[430] font-season text-[14px] text-black transition-colors hover:border-[#E0E0E0] hover:bg-[#2DAC72] dark:bg-[#33c482] dark:text-black dark:hover:border-[#E0E0E0] dark:hover:bg-[#2DAC72]'
+          className='mt-2 inline-flex h-[30px] w-fit items-center rounded-[5px] bg-[#33C482] px-[10px] font-medium text-[12px] text-[#1b1b1b] transition-colors hover:bg-[#2DAC72]'
           aria-label='Get started with Sim - Sign up for free'
         >
           Get started
-          <span className='relative inline-flex h-4 w-4 transition-transform duration-200 group-hover:translate-x-0.5'>
-            <ChevronRight
-              className='absolute inset-0 h-4 w-4 transition-opacity duration-200 group-hover:opacity-0'
-              aria-hidden='true'
-            />
-            <ArrowRight
-              className='absolute inset-0 h-4 w-4 opacity-0 transition-opacity duration-200 group-hover:opacity-100'
-              aria-hidden='true'
-            />
-          </span>
         </Link>
       </div>
     </div>

apps/docs/components/docs-layout/toc-footer.tsx

@@ -1,12 +1,14 @@
 'use client'
 
+import { CircleHelp } from 'lucide-react'
 import Link from 'next/link'
 import { usePathname } from 'next/navigation'
 import { LanguageDropdown } from '@/components/ui/language-dropdown'
 import { SearchTrigger } from '@/components/ui/search-trigger'
 import { SimLogoFull } from '@/components/ui/sim-logo'
 import { ThemeToggle } from '@/components/ui/theme-toggle'
 import { cn } from '@/lib/utils'
+import { DiscordIcon } from '../icons'
 
 const NAV_TABS = [
   {
@@ -21,16 +23,14 @@ const NAV_TABS = [
     match: (p: string) => p.includes('/api-reference'),
     external: false,
   },
-  { label: 'Mothership', href: 'https://sim.ai', external: true },
   { label: 'Changelog', href: 'https://sim.ai/changelog', external: true },
-
 ] as const
 
 export function Navbar() {
   const pathname = usePathname()
 
   return (
-    <nav className='sticky top-0 z-50 bg-background/80 backdrop-blur-md backdrop-saturate-150'>
+    <nav className='sticky top-0 pt-2 z-50 bg-background/80 backdrop-blur-md backdrop-saturate-150'>
       <div className='hidden w-full flex-col lg:flex'>
         {/* Top row: logo, search, controls */}
         <div
@@ -48,7 +48,26 @@ export function Navbar() {
             <SearchTrigger />
           </div>
 
-          <div className='flex items-center gap-1.5'>
+          <div className='flex items-center gap-2'>
+            <Link
+              href='https://discord.gg/Hr4UWYEcTT'
+              target='_blank'
+              rel='noopener noreferrer'
+              className='inline-flex h-[30px] items-center gap-[6px] rounded-[5px] border border-neutral-200 bg-white px-[10px] font-medium text-[12px] text-neutral-700 transition-colors hover:border-neutral-300 hover:bg-neutral-50 dark:border-neutral-700 dark:bg-neutral-800 dark:text-neutral-300 dark:hover:border-neutral-600 dark:hover:bg-neutral-700'
+              aria-label='Get help on Discord'
+            >
+              <DiscordIcon className='h-[13px] w-[13px]' />
+              Discord
+            </Link>
+            <Link
+              href='https://sim.ai'
+              target='_blank'
+              rel='noopener noreferrer'
+              className='inline-flex h-[30px] items-center rounded-[5px] bg-[#33C482] px-[10px] font-medium text-[12px] text-[#1b1b1b] transition-colors hover:bg-[#2DAC72]'
+              aria-label='Go to Sim AI'
+            >
+              Mothership
+            </Link>
             <LanguageDropdown />
             <ThemeToggle />
           </div>

apps/docs/components/navbar/navbar.tsx

@@ -29,8 +29,8 @@ function ContentCopyButton({ content, className, ...props }: { content: string }
     <button
       onClick={onClick}
       className={cn(
-        'flex cursor-pointer items-center gap-1.5 rounded-lg border border-border/40 bg-background px-2.5 py-2 text-muted-foreground/60 text-sm leading-none transition-all hover:border-border hover:bg-accent/50 hover:text-muted-foreground',
-        className,
+        'inline-flex cursor-pointer items-center justify-center gap-1.5 rounded-lg border border-border/40 bg-background px-2.5 py-1.5 text-muted-foreground/60 text-sm transition-all hover:border-border hover:bg-accent/50 hover:text-muted-foreground',
+        className
       )}
       aria-label={checked ? 'Copied to clipboard' : 'Copy page content'}
       {...props}
@@ -50,14 +50,16 @@ function ContentCopyButton({ content, className, ...props }: { content: string }
   )
 }
 
-export function LLMCopyButton({ content, markdownUrl, children, className, ...props }: LLMCopyButtonProps) {
+export function LLMCopyButton({
+  content,
+  markdownUrl,
+  children,
+  className,
+  ...props
+}: LLMCopyButtonProps) {
   if (markdownUrl) {
     return (
-      <MarkdownCopyButton
-        markdownUrl={markdownUrl}
-        className={className}
-        {...props}
-      >
+      <MarkdownCopyButton markdownUrl={markdownUrl} className={className} {...props}>
         {children ?? 'Copy Markdown'}
       </MarkdownCopyButton>
     )

apps/docs/components/page-actions.tsx

@@ -0,0 +1,76 @@
+---
+title: Sim Mailer
+description: Send emails to your workspace and let Sim handle them as tasks.
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { FAQ } from '@/components/ui/faq'
+
+Sim Mailer gives your workspace a dedicated email address. Forward or send emails to it and Sim will process them as tasks — reading the subject, body, and any attachments, then replying to the thread with the result.
+
+This means you can interact with Sim directly from your email client without switching apps.
+
+## Getting Started
+
+1. Navigate to **Settings** → **Inbox**
+2. Toggle the inbox on
+3. Optionally choose a custom address prefix (e.g., `acme` → `acme@mothership.sim.ai`)
+4. Copy your inbox address and start sending emails
+
+If you skip the custom prefix, one is generated automatically.
+
+<Callout type="info">
+  Changing your address creates a new inbox. The old address stops working immediately.
+</Callout>
+
+## What You Can Send
+
+Write your email like you would to a colleague. The subject and body become the task prompt.
+
+**Attachments are fully supported.** Images, PDFs, and documents (up to 10 MB each) are read by Sim and displayed inline in the conversation — image attachments show as previews, just like when you upload them directly in the chat.
+
+| Good email | Why it works |
+|------------|-------------|
+| "Summarize the attached PDF and list action items" | Clear task with an attachment |
+| "What's in this image?" with a photo attached | Sim reads and describes the image |
+| "Draft a reply to this forwarded thread" | Uses the email body as context |
+
+## Allowed Senders
+
+Only authorized senders can create tasks. Emails from anyone else are automatically rejected.
+
+- **Workspace members** are allowed by default — no setup needed
+- **External senders** can be added manually with an optional label for easy identification
+
+Manage your allowed senders list in **Settings** → **Inbox** → **Allowed Senders**.
+
+## Tracking Tasks
+
+Every email becomes a task you can track in **Settings** → **Inbox**:
+
+- **Search** by subject, sender, or body content
+- **Filter** by status to find what you need
+- **Click** any completed or failed task to jump to the full conversation
+
+### Task Statuses
+
+| Status | Meaning |
+|--------|---------|
+| **Received** | Email accepted, queued for processing |
+| **Processing** | Sim is actively working on it |
+| **Completed** | Done — the result was sent as an email reply |
+| **Failed** | Something went wrong during execution |
+| **Rejected** | Email blocked (sender not allowed, automated sender, or rate limit exceeded) |
+
+## Conversations
+
+Each email task creates a conversation in your workspace. You can continue the conversation from the Sim chat interface, and any follow-up emails in the same thread are linked to the same conversation.
+
+<FAQ items={[
+  { question: "Can I use my own email domain?", answer: "Not currently. All inbox addresses use the @mothership.sim.ai domain. You can customize the prefix (e.g., acme@mothership.sim.ai) but not the domain itself." },
+  { question: "What happens if I send from an unauthorized email?", answer: "The email is automatically rejected. Only workspace members and manually added external senders can create tasks." },
+  { question: "Is there a size limit for attachments?", answer: "Yes, each attachment can be up to 10 MB. Images, PDFs, and common document formats are supported." },
+  { question: "Can I reply to Sim's email responses?", answer: "Yes. Replies in the same email thread are linked to the original conversation, so you can continue the interaction from your email client." },
+  { question: "How long does it take to process an email?", answer: "Most emails are processed within a few seconds. Emails with large attachments or complex tasks may take slightly longer." },
+  { question: "Can multiple people in my workspace use the same inbox?", answer: "Yes. All workspace members can send to the shared inbox address. Each email creates its own task and conversation." },
+]} />

apps/docs/content/docs/de/mailer/index.mdx

@@ -1,23 +1,32 @@
 {
-  "title": "Sim Documentation",
+  "title": "Sim-Dokumentation",
   "pages": [
+    "---Grundlagen---",
     "./introduction/index",
     "./getting-started/index",
-    "./quick-reference/index",
+    "---Kernkonzepte---",
     "triggers",
     "blocks",
     "tools",
     "connections",
+    "knowledgebase",
+    "tables",
+    "---Integrationen---",
     "mcp",
     "copilot",
+    "mailer",
     "skills",
-    "knowledgebase",
+    "---Sicherheit & Konfiguration---",
     "variables",
     "credentials",
-    "execution",
     "permissions",
+    "---Ausführung & Betrieb---",
+    "execution",
+    "---Bereitstellung---",
     "self-hosting",
     "./enterprise/index",
+    "---Referenz---",
+    "./quick-reference/index",
     "./keyboard-shortcuts/index"
   ],
   "defaultOpen": false