diff --git a/docs/desktop/getting-started/overview.mdx b/docs/desktop/getting-started/overview.mdx new file mode 100644 index 00000000..7c57ac2a --- /dev/null +++ b/docs/desktop/getting-started/overview.mdx @@ -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 + + + + Download for M1/M2/M3 + + + Download for Intel + + + Download for Windows + + + +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 + + + + Get up and running in 5 minutes + + + Connect Slack, Linear, and other tools + + + + + **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. + diff --git a/docs/desktop/getting-started/quickstart.mdx b/docs/desktop/getting-started/quickstart.mdx new file mode 100644 index 00000000..3027a866 --- /dev/null +++ b/docs/desktop/getting-started/quickstart.mdx @@ -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 + + + + + + M1/M2/M3 + + + Intel + + + Windows x64 + + + + + + - **Mac**: Open the `.dmg` file and drag Factory to Applications + - **Windows**: Run the installer + + + + Launch Factory and sign in with your account. + + + +## Step 2: Connect to Your Codebase + + + + Set your working directory to your project folder. Factory connects directly to your local machine. + + + + Choose your preferred model from the model selector. You can change this anytime. + + + +## Step 3: Start Building + + + + 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. + + + +## Optional: Customize your setup + +### Chat Input + +Use the chat input controls in the header to adjust things like model selection and planning mode. + +Chat input controls in Factory (Desktop) + +### Native MCP Support + +Open the MCP registry to add servers or configure them manually. + +Add MCP servers from the registry + +## 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 + + + + Connect Slack, Linear, and other tools + + + Use Droid from your terminal + + diff --git a/docs/docs.json b/docs/docs.json index 3f6151c2..db523eea 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -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" diff --git a/docs/images/desktop/add-mcp-server.png b/docs/images/desktop/add-mcp-server.png new file mode 100644 index 00000000..66562031 Binary files /dev/null and b/docs/images/desktop/add-mcp-server.png differ diff --git a/docs/images/desktop/prompt-settings.png b/docs/images/desktop/prompt-settings.png new file mode 100644 index 00000000..7e1b0f37 Binary files /dev/null and b/docs/images/desktop/prompt-settings.png differ diff --git a/docs/welcome/index.mdx b/docs/welcome/index.mdx index 95dd4c00..8360bc83 100644 --- a/docs/welcome/index.mdx +++ b/docs/welcome/index.mdx @@ -25,8 +25,8 @@ Factory is an AI-native software development platform that works everywhere you Get started with our CLI. - - Explore our web interface. + + Get started with Factory (Desktop).