Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 60 additions & 0 deletions docs/desktop/getting-started/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
title: Overview
sidebarTitle: Overview
description: If it can be done on a computer, it can be done with a Droid.
keywords: ['factory (desktop)', 'desktop app', 'droid', 'local machine', 'download', 'install', 'mac', 'windows', 'ai coding', 'coding assistant']
---

## Download and start in 30 seconds

<CardGroup cols={3}>
<Card title="Mac (Apple Silicon)" icon="apple" href="https://app.factory.ai/api/desktop?platform=darwin&architecture=arm64">
Download for M1/M2/M3
</Card>
<Card title="Mac (Intel)" icon="apple" href="https://app.factory.ai/api/desktop?platform=darwin&architecture=x64">
Download for Intel
</Card>
<Card title="Windows" icon="windows" href="https://app.factory.ai/api/desktop?platform=win32">
Download for Windows
</Card>
</CardGroup>

Install, sign in, set your working directory, and start building. [Try the quickstart →](/desktop/getting-started/quickstart)

## What Factory (Desktop) brings to your workflow

- **Native desktop experience**: A dedicated app with Droid built-in — no browser tabs, no setup complexity. Just download and start coding.
- **Local machine connection**: Work directly on your local filesystem with full access to your development environment, tools, and workflows.
- **Mission Mode**: Pursue larger goals over longer horizons with plan/approval loops and continuous validation.
- **Deep codebase understanding**: Droid leverages your project context, documentation, and team knowledge to provide contextually aware assistance.
- **Engineering system integration**: Connect to Jira, Notion, Slack, Linear, PagerDuty, and more — so development work stays synchronized with your team.
- **Native MCP Support**: Connect tools through the built-in MCP registry to extend Droid with external services.

## Why teams choose Factory

- **Built for enterprise**: SOC-2 compliance, on-premise deployment options, and security-first design.
- **Transparent and controllable**: Every change Droid proposes is visible and reviewable before approval.
- **Model flexibility**: Choose from multiple AI models and route tasks to the best model for each job.

## Next steps

<CardGroup cols={2}>
<Card
title="Quickstart"
icon="rocket"
href="/desktop/getting-started/quickstart"
>
Get up and running in 5 minutes
</Card>
<Card
title="Integrations"
icon="plug"
href="/integrations/linear"
>
Connect Slack, Linear, and other tools
</Card>
</CardGroup>

<Note>
**Looking for Factory Bridge or Remote Workspaces?** Factory (Desktop) replaces both. The desktop app connects directly to your local machine with Droid built-in — no separate applications or cloud workspaces needed.
</Note>
131 changes: 131 additions & 0 deletions docs/desktop/getting-started/quickstart.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,131 @@
---
title: "Quickstart"
description: "Get up and running with Factory (Desktop) in 5 minutes"
keywords: ['quickstart', 'getting started', 'factory (desktop)', 'desktop app', 'droid', 'setup', 'install', 'download', 'local machine', 'working directory']
---

## Step 1: Download and Install

<Steps>
<Step title="Download Factory (Desktop)">
<CardGroup cols={3}>
<Card title="Mac (Apple Silicon)" icon="apple" href="https://app.factory.ai/api/desktop?platform=darwin&architecture=arm64">
M1/M2/M3
</Card>
<Card title="Mac (Intel)" icon="apple" href="https://app.factory.ai/api/desktop?platform=darwin&architecture=x64">
Intel
</Card>
<Card title="Windows" icon="windows" href="https://app.factory.ai/api/desktop?platform=win32">
Windows x64
</Card>
</CardGroup>
</Step>

<Step title="Install">
- **Mac**: Open the `.dmg` file and drag Factory to Applications
- **Windows**: Run the installer
</Step>

<Step title="Sign in">
Launch Factory and sign in with your account.
</Step>
</Steps>

## Step 2: Connect to Your Codebase

<Steps>
<Step title="Set your working directory">
Set your working directory to your project folder. Factory connects directly to your local machine.
</Step>

<Step title="Select your model">
Choose your preferred model from the model selector. You can change this anytime.
</Step>
</Steps>

## Step 3: Start Building

<Steps>
<Step title="Ask Droid anything">
Start with something simple:

```
Analyze this codebase and explain the architecture
```

Or jump straight into coding:

```
Add error handling to the user authentication flow
```

Droid will analyze your codebase, propose changes, and show you exactly what will be modified before applying anything.
</Step>
</Steps>

## Optional: Customize your setup

### Chat Input

Use the chat input controls in the header to adjust things like model selection and planning mode.

<img
src="/images/desktop/prompt-settings.png"
alt="Chat input controls in Factory (Desktop)"
style={{ width: '100%', height: 'auto' }}
className="rounded-lg"
/>

### Native MCP Support

Open the MCP registry to add servers or configure them manually.

<img
src="/images/desktop/add-mcp-server.png"
alt="Add MCP servers from the registry"
style={{ width: '100%', height: 'auto' }}
className="rounded-lg"
/>

## Example Workflows

### Feature Development

```
Implement a dark mode toggle following our existing theme patterns
```

### Bug Fixing

```
Fix the authentication timeout issue where users get logged out after 5 minutes
```

### Code Review

```
Review this PR and suggest improvements for error handling and edge cases
```

### Security Audit

```
Audit this codebase for security vulnerabilities and create a remediation plan
```

## Tips

- **Be specific**: Include relevant details like file names, error messages, or ticket numbers
- **Use context**: Reference team tools with '@' mentions or paste links directly
- **Review changes**: Always review Droid's proposed changes before approval

## Next Steps

<CardGroup cols={2}>
<Card title="Integrations" icon="plug" href="/integrations/linear">
Connect Slack, Linear, and other tools
</Card>
<Card title="CLI" icon="terminal" href="/cli/getting-started/overview">
Use Droid from your terminal
</Card>
</CardGroup>
6 changes: 3 additions & 3 deletions docs/docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -82,10 +82,10 @@
]
},
{
"group": "App",
"group": "Desktop",
"pages": [
"web/getting-started/overview",
"web/getting-started/quickstart"
"desktop/getting-started/overview",
"desktop/getting-started/quickstart"
]
},
"pricing"
Expand Down
Binary file added docs/images/desktop/add-mcp-server.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/desktop/prompt-settings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/welcome/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,8 @@ Factory is an AI-native software development platform that works everywhere you
<Card title="CLI" icon="square-terminal" href="/cli/getting-started/quickstart">
Get started with our CLI.
</Card>
<Card title="Web" icon="browser" href="/web/getting-started/overview">
Explore our web interface.
<Card title="Desktop" icon="computer" href="/desktop/getting-started/overview">
Get started with Factory (Desktop).
</Card>
</CardGroup>

Expand Down