+
+
+
+
+
+
+
+
+
+
+
+
+## Themes
+
+Switch between light and dark themes to suit your preference.
+
+## Default Agent Configuration
+
+Choose the default agent and variant for new task attempts. This profile is pre-selected when creating new task attempts and follow-ups.
+
+1. **Select an agent** (e.g., Claude Code, Gemini CLI, Codex)
+2. **Choose a variant** if available (e.g., Default, Plan, Router)
+
+
+
+
+## Creating Your Project
+Click the **Create Project** button to choose from two options:
+- **From existing git repository**: Browse your file system and select from a list of git repositories sorted by recent activity
+- **Create blank project**: Generate a new git repository from scratch
+Each project represents a git repository. After creation, you can configure it with setup scripts, dev server scripts, and other settings.
+
+
+
+
+
+After creating a project, add tasks by clicking the **plus (+) icon** in the top right of your project kanban page, or by using the keyboard shortcut **`c`**. Creating a task adds it to your kanban board without automatically starting a coding agent.
+
+## Using Templates
+
+
+
+
+
+When adding a task, you can select from your saved templates:
+
+1. Click the **Use a template** dropdown
+2. Choose from available global or project templates
+3. The template automatically populates the task title and description
+
+
+
+
+To activate a coding agent on your task, create a task attempt:
+
+
+
+
+
+
+To create a subtask from an existing task attempt:
+
+
+
+
+When viewing a parent task, you can see its subtasks in the **Task Relationships** panel. This collapsible section shows:
+
+- **Child Tasks** with a count (e.g., "CHILD TASKS (1)")
+- Individual subtask titles with links to view them
+- Easy navigation between parent and child tasks
+
+This helps you track progress across all related work items and understand the task hierarchy at a glance.
+
+## Viewing Subtask Details
+
+
+
+
+
+When viewing a subtask, the **Task Relationships** panel displays:
+
+- **Parent Task** section showing the parent task title
+- Direct link to navigate to the parent task
+- Clear visual indication that this is a child task
+- Context about the parent-child relationship
+
+The subtask also shows its own **Create Subtask** button, allowing you to create nested subtasks if needed.
+
+## How Subtasks Work
+
+Subtasks in Vibe Kanban follow these key principles:
+
+### Git Branching Workflow
+
+Subtasks create their own feature branches that can work independently while maintaining connection to the parent task:
+
+```mermaid
+gitGraph
+ commit id: "main"
+ branch feature/parent-task
+ checkout feature/parent-task
+ commit id: "Parent Task Start"
+ commit id: "Initial work"
+
+ branch feature/subtask-1
+ checkout feature/subtask-1
+ commit id: "Subtask 1: Backend API"
+ commit id: "API implementation"
+ commit id: "API tests"
+
+ checkout feature/parent-task
+ branch feature/subtask-2
+ checkout feature/subtask-2
+ commit id: "Subtask 2: Frontend UI"
+ commit id: "Component creation"
+ commit id: "UI styling"
+
+ checkout feature/parent-task
+ branch feature/subtask-3
+ checkout feature/subtask-3
+ commit id: "Subtask 3: Integration"
+ commit id: "Connect API to UI"
+
+ checkout feature/parent-task
+ merge feature/subtask-1
+ merge feature/subtask-2
+ merge feature/subtask-3
+ commit id: "Parent Task Complete"
+
+ checkout main
+ merge feature/parent-task
+```
+
+### Parent-Child Relationships
+
+- Subtasks are linked to specific **task attempts**, not just tasks
+- Each subtask knows which attempt created it
+- Multiple subtasks can be created from the same parent attempt
+
+### Branch Inheritance
+
+- Subtasks automatically inherit the base branch from their parent attempt
+- This ensures subtasks work within the same development context
+- You can modify the branch when creating the subtask if needed
+
+### Independent Task Lifecycle
+
+- Subtasks appear as regular tasks on your kanban board
+- Each subtask has its own lifecycle (To do → In Progress → In Review → Done)
+- Subtasks can have their own task attempts and coding agents
diff --git a/docs/core-features/task-details-full-screen.mdx b/docs/core-features/task-details-full-screen.mdx
new file mode 100644
index 00000000..582e9a8b
--- /dev/null
+++ b/docs/core-features/task-details-full-screen.mdx
@@ -0,0 +1,135 @@
+---
+title: "Task Details Full Screen Mode"
+sidebarTitle: "Full Screen Mode"
+description: "Complete guide to using the task details full screen mode for development workflows, including dev server, git operations, logs, diffs, and process monitoring"
+---
+
+## Accessing Full Screen Mode
+
+Click the **Maximise** button (⛶) in the task details header to expand the view to occupy the full right side of your screen. Some task actions (like "View full diff") automatically switch to full screen mode for better visibility.
+
+
+
+
+
+## Interface Layout
+
+Full screen mode uses a two-column layout:
+
+### Left Sidebar
+- **Task Information**: Title, description, and metadata
+- **Development Toolbar**: Primary development actions
+- **TODOs**: Task checklist and progress tracking
+- **Relationships**: Subtasks and parent task links
+
+### Right Panel
+- **Tab Navigation**: Switch between Logs, Diffs, and Processes
+- **Content Area**: Active tab content with real-time updates
+- **Follow-up Section**: Additional context and actions
+
+## Core Features
+
+### Development Server
+
+Start and manage your project's development environment directly from the task interface.
+
+**Controls:**
+- **Dev** (▶️): Start the development server using your project's configured dev script
+- **Stop Dev** (⏹️): Terminate the running development server
+- **View Logs** (📄): Jump to process logs to monitor server output
+
+The development server runs in a git worktree environment and streams all output to the Processes tab. Click the logs button next to the dev server control to jump directly to the process logs for real-time monitoring.
+
+### Git Operations
+
+#### Rebase
+Keep your task branch up-to-date with the latest changes from the base branch.
+
+- **Automatic Detection**: The rebase button appears when your branch is behind the base branch
+- **Conflict Handling**: Any merge conflicts are displayed in the Diffs tab
+
+#### Merge
+Integrate your completed work back into the base branch.
+
+- **Availability**: Disabled when an open pull request exists
+- **Success Indication**: A "Merged!" notification confirms successful integration
+
+#### Push & Pull Request Management
+- **Create PR**: Opens pull request creation dialog for new branches
+- **Push to PR**: Updates existing pull request with latest changes
+- **Auto-detection**: Automatically detects existing PRs and adjusts button behavior
+
+### Task Management
+
+#### History & Attempts
+View and manage all task attempts from the full screen interface.
+
+- **History**: View all previous attempts for this task, review execution status and outcomes, and switch between different attempts to compare results
+- **New Attempt**: Create additional attempts when previous approaches didn't work as expected or when testing different implementation strategies
+
+
+
+
+#### Diffs Tab
+The Diffs tab provides a visual representation of all code changes made during task execution. It shows a git diff between your branch and the base branch, with syntax highlighting and language-aware code formatting. You can see a summary of added, modified, and deleted files with precise line-by-line change tracking and context.
+
+
+
+
+
+Learn more in [Reviewing Code Changes](/core-features/reviewing-code-changes).
+
+#### Processes Tab
+The Processes tab displays a timeline view of all running and completed processes. You can track the status of running, completed, failed, and stopped processes with their complete execution timeline. Click any process to view its specific output logs, and use the interactive controls to stop running processes directly from the interface.
+
+
+
+
+
+## Navigation & Controls
+
+### Keyboard Shortcuts
+- **Escape**: Exit full screen mode and return to sidebar view
+- **Tab Navigation**: Use browser tab controls to switch between Logs, Diffs, and Processes
+
+
+
+## Exiting Full Screen Mode
+
+- Click the **Minimize** button in the header
+- Press **Escape** key
+- Click the **×** button to close the task panel entirely
+- Navigate to a different task or project
+
+The interface gracefully transitions back to the compact sidebar view while preserving your work context.
+
+## Related Documentation
+
+- [Creating Task Attempts](/core-features/creating-task-attempts) - Learn about task attempt lifecycle
+- [Reviewing Code Changes](/core-features/reviewing-code-changes) - Deep dive into diff analysis
+- [Creating Tasks](/core-features/creating-tasks) - Task creation and management
+- [Agent Configurations](/configuration-customisation/agent-configurations) - Customise AI agent behaviour
diff --git a/docs/development.mdx b/docs/development.mdx
deleted file mode 100644
index ac633bad..00000000
--- a/docs/development.mdx
+++ /dev/null
@@ -1,94 +0,0 @@
----
-title: 'Development'
-description: 'Preview changes locally to update your docs'
----
-
-
-
-
-## Code formatting
-
-We suggest using extensions on your IDE to recognize and format MDX. If you're a VSCode user, consider the [MDX VSCode extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) for syntax highlighting, and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) for code formatting.
-
-## Troubleshooting
-
-
-
-## Image
-
-### Using Markdown
-
-The [markdown syntax](https://www.markdownguide.org/basic-syntax/#images) lets you add images using the following code
-
-```md
-
-```
-
-Note that the image file size must be less than 5MB. Otherwise, we recommend hosting on a service like [Cloudinary](https://cloudinary.com/) or [S3](https://aws.amazon.com/s3/). You can then use that URL and embed.
-
-### Using embeds
-
-To get more customizability with images, you can also use [embeds](/writing-content/embed) to add images
-
-```html
-
-```
-
-## Embeds and HTML elements
-
-
-
-... snippet content ...
-S2*fufYQYh+hZM40HI|%|s>S_jRjNv3>2H(FGj_YMLQ
zT@?bss&YMf=2YkBri%valLBGNRG;I(yiB+K0avM>pi`jeDbMqTrwLg3zOL(3bXBso
z`nLHc9e?|!K>+Bwdap_JwBtS5Samnoo5CYZI$DHL;LOQG-r(GX6D<5T5Btw4d=C5o
z#BWDO+_-kTx;wV?O@K4OvjNE$4Y9n2GGE>f6Pq6ey{DkrFBo*{Dq~I3hY}d@UH7;A
zMV`R5yak#l%XSF&;H$HJ$C7q^CKcP}Zm=n&=QPV_U-B#y#E@_^`T|y#+{StP5Wj|<
z)8+OCaBdT~yRx=6ZIwN a+IU&VZpuzst
zn+tQV^k`_2J=rQ2)!`k6;jJ&164gI;#JQc;e;cRrd||M*tzA!n3Pq8;)6?A!wPXY`
z38s}`k&*iKA41N;fD#fcSQmqk%*U+#4g8=Fzxp#sCmCqiSm|IstK%a9E5hMX$fpes
zyB4nRR-Z*Vtp?9uCu uM%-Qp-z0x&^rW4+_s{HC)P~M
zB|Q^KF!i>E#@$>q!KSpQ!^ta?FOW`c*MC5-7&M|{(v8>62n%#D?xQlzUF*$fx#)s6
zpO}#I1~WjrV0_~-UAXWrr*}WAU4Ax>CBJj7*moHFDIo8wOw*>?q^Q1p;{+Q_K01T^
zWfWOL@`pzi!K!xV@XDiZ(hQ7?o 81
zI8TvQ0a5OXf$0h`GsU57<`w=`TZy`AJJzps1i~%mNL}B&F>{xOp=|{u1nk()N!E-A
zxwG5DnJ@@k_Ek#_0_o8w{W-8G1PE`>^Y0&3iW!Khh_FotM;P*kDAje+1)&huS~lf3+0sS|*EY
zAls8f={ZI17xw9_kJk(f1BVW`tXbKVob0QFucQuvO_lAEnLe0d3zspKh&k^soZGuR
zN=2V6Lri(zFJ(w|=AnaCGF{EN?%-yhZl}P~$&sxw*EmBLHnRn8C&&**d~?^Ej-LdN
z=h%va584MiDAGh(E@I^NN3){K`Z-IYA!hNvdkasrtq6^DQV|)
zpwqzY0z0NRFKyu|TZ~hNY#u6w#Y_dBlm!_IYYMf?ow=5R(7`8-$M^R&Vwmwve@GhN
zv0Ewm4xe{7`mN!umA!*oQOfhrQvIg_4Ej9>4$b%>43XHfS?IXH4z2MP=qj@?(sGfMJzc6%|au
zC+0E+2A^U6ZJn!>AI6bvG0M8PLRu_8?BUx{0IU`(XBwOPQ|&NeAXiCH2TgPwU5Hgl
ziL`vJbJh`gxR8f0)?(kf2ZOtYzCq#5X}B}7Xgo`8G}slX$)6ULMGFom(ajaf73Gty
zV((Z(SSRBaP>;BHPZhSwtCpiNMwz8IF#F-CL;m!Zq;*J@8p*MyQ)!x%{KS0)Gq{l(
z4e?FDq}VB|U@2Dw?nF03KA0OKZ+U%y&Hi+ekqGY=UOvUSNGt`Es-!0F@|-TMEIqrr
z-T1r=>41f7cq+L6>T%t*0t>wBS7sbt%oU*)<8%=qzOtt%L!=uTCN;ocQqP-I+cFv&
z$87)dAnsBjr`GfPE
TQAG4B)M#b3*9Cn|S!QS}Lb%
zeL)#9`nnMkamz{hnupBl2K}7wpxfyxM3QYI$SvhWN=i>uTy$bM!#qq=Tx2K#H(?1`
z68J%M77f$pHR1T`;4)Pc?{zVUZG@o3sM6C0J@FUrL$;an&M1MXnpCqnT&+QeuB4$%
z8f&tFgA=;D*0!s2r?$bpaYEYl?*XNbsSg9MFs#D}d8+IoICbtndvuF%Jt2}kh*FR4
zhi0u7Am*g%c_|!7ZO?SXbSZ~Sjos&(E+m5TMlMg_fJ5^pV9->%cXwFzFvAzZVlmgO
zsToW^RTU?y!bj8Xap78^B3;#>&{7}9De-cGAg`V*EohFqZL!G^5uL4$8XML)A|e}z
zNdIiV%)A%Bl`>I-ZaeLlx_7jEv$M=q%Ev3ZNj;46p3CqM#Wc1KfN4u?`Yb5JgYxhZ
z3U-(QdZ&YI