Getting Started with Warren
Warren takes under 10 minutes to set up. Follow the steps below to go from fresh install to your first project scheduled on the timeline.
First launch
When you open Warren for the first time, the app generates a one-time superadmin password. This is the only time you'll ever see it.
After acknowledging the credential screen, Warren drops you into the Setup Wizard.
Saving your credentials
The credential reveal screen shows:
- Username â defaults to your macOS username.
- Superadmin password â a randomly generated string. Copy it before continuing.
Setup wizard
The setup wizard walks you through five screens. You can always change these settings later in Settings â General.
Name your workspace
Enter your studio or company name. This appears in reports, share links, and Slack notifications.
Pick a brand color
Warren uses this color for accents, charts, and the sidebar. Choose something that matches your brand.
Set your working days
Toggle which days of the week your studio works. Warren uses this to calculate capacity and skip non-working days on the timeline.
Connect Harvest (optional)
Paste your Harvest Account ID and Personal Access Token to enable two-way time sync. You can skip this and connect later in Settings.
Connect Slack (optional)
Add your Slack Bot Token and App Token to let your team log hours directly in Slack. Skip for now and configure in Settings â Integrations.
Interactive onboarding tour
After completing the wizard, Warren plays an eight-slide tutorial. Swipe through it â each slide demonstrates a key feature area:
| Slide | What it covers |
|---|---|
| 1 â Welcome | Overview of all feature areas |
| 2 â Free vs Pro | Plan limits & upgrade benefits |
| 3 â Unlimited Projects | Pro plan project capacity |
| 4 â Timesheets | Harvest two-way sync |
| 5 â Slack Logging | Bot hour-logging commands |
| 6 â Project Lifecycle | 9 design phases & Gantt charts |
| 7 â Epics, Tasks & Comments | Kanban boards, task assignment & activity feed |
| 8 â Budget View | Burn rate & workload visualization |
Navigation basics
Warren's sidebar has seven sections. Each is accessible with a keyboard shortcut:
| Section | Who can access | Shortcut |
|---|---|---|
| Timeline | Everyone | â1 |
| Projects | Manager Admin | â2 |
| Clients | Manager Admin | â3 |
| Team | Admin | â4 |
| Insights | Manager Admin | â5 |
| Invoices | Manager Admin | â6 |
| Reports | Manager Admin | â7 |
| My Work | Designer | Default view |
Keyboard shortcuts
| Action | Shortcut |
|---|---|
| New project | âN |
| Log hours | âL |
| New Epic | ââ§E |
| New Task | âT |
| Show keyboard shortcuts | â/ |
| Open Settings | â, |
| Navigate sidebar sections | â1 â â7 |
