Structure

DollarDeploy Structure & Navigation

Dashboard (/dashboard)

• Quick stats cards: Subscription, Servers count, Apps count, Integrations
• Welcome guide for new users
• Support resources

Servers/Hosts (/host)

• List View (/host): Table with tabs (All, Active, Draft, Archived)
  • Shows: Name, IP address, Apps, Status, Created date
  • Actions: View, Edit, Logs, Delete
  • Group by Project support
• Detail View (/host/[id]): Tabs - Overview, Services, Journal
  • Overview: Host info, health metrics, apps list
  • Actions: Test connection, Prepare host, Backup, Console access
• Edit View (/host/[id]/edit): Configure host details
• Provision View (/host/[id]/provision): Create host via cloud provider

Apps (/app)

• List View (/app): Table with tabs (All, Active, Draft, Archived)
  • Shows: Name, Type, Status, Last Deployed, Host
  • Actions: Launch, View, Edit, Logs, Delete
  • Sortable columns, Group by Project support
• Detail View (/app/[id]): Tabs - Overview, App files, Journal
  • Overview: App info, build/deploy details, Deploy automatically (enable deploy on git push)
  • Actions: Deploy, Build only, Deploy latest build, Backup
• Edit View (/app/[id]/edit): Configure app settings
• Create View (/app/create): Create new application

Tasks (/task)

• Table with tabs: All, Active, Error, Completed
• Shows: Type, Status, Host, App, Created, Executed, Result
• Actions: View log, Cancel (for active tasks)

Settings (/settings/[tab])

• General: Account settings, profile
• Subscription: Plan management, limits
• Users: Team member management, invites
• Referral: Referral program
• Notifications: Alert preferences, maintenance windows
• SSH: SSH key management
• API: API key management
• MCP: AI/MCP server configuration
• Projects: Organize apps/hosts into projects
• Integrations: Cloud provider connections (DigitalOcean, Hetzner, etc.)
• Backup: Backup provider configuration
• GitHub: GitHub app integration
• Templates: Custom YAML deployment templates
• About: Version info

Application Workflows

1. Server Setup Flow

Add Host → Configure → Test Connection → Prepare → Ready for Apps
    │
    ├── Manual: Enter IP, SSH key, username → Test → Prepare
    │
    └── Provision: Select provider → Choose region/type → Create → Auto-configure

2. App Deployment Flow

Add App → Configure → Build → Deploy → Live
    │
    ├── From Scratch: Select type → Configure repo/settings → Build → Deploy
    │
    └── From Template: Select template → Choose host → Launch (auto build+deploy)

3. One-Click Deploy Flow (Templates)

/r → Select Template → Choose exsiting host/Provision new one → Configure → Launch

Pages:

• /r - Template gallery (pages/r/index.tsx)
• /r/[templateId] - Template details
• /r/[templateId]/host - Choose existing host or provision new
• /r/[templateId]/provision - Configure cloud provisioning
• /r/[templateId]/existing - Use existing host
• /r/[templateId]/launch - Execute deployment

4. Task Execution Flow

All long-running operations create Tasks that execute asynchronously:

Request → Create Task → Queue → Execute → Complete/Error
                ↓
         Real-time status via polling

Task Types:

• build:app - Build application
• deploy:app - Deploy to host
• prepare:host - Configure host
• provider:host:create - Provision cloud server
• provider:host:delete - Delete cloud server
• backup:host / backup:app - Create backups
• remove:app - Remove application

5. Authentication Flow

Sign Up/Sign In → Onboarding → Dashboard
       │
       ├── OAuth: Google, GitHub
       └── Email: Magic link (production)

Pages:

• /auth/signIn - Login page
• /auth/signUp - Registration page
• /auth/onboarding - New user setup
• /auth/checkCode - Email verification