Skip to content

Latest commit

 

History

History
240 lines (171 loc) · 9.72 KB

File metadata and controls

240 lines (171 loc) · 9.72 KB

Business Strategy: dotfiles.download Platform

Executive Summary

The iam-dotfiles repository contains unique assets that far exceed a typical dotfiles repo: a 4,800-line TUI framework (Serotonin), a modular pack system (14 packs), cross-platform install automation, diagnostic tools, and a branded domain (dotfiles.download). None of these generate value while buried inside a personal config repo.

The opportunity: Transform from a personal dotfiles repo into a developer environment platform — the missing layer between "naked chezmoi" and "full corporate desktop management."

No direct competitors exist in this space. The closest analogies are gitignore.io (just .gitignore), readme.so (just README), and starter.dev (project scaffolding, not environments).


Current Assets

Asset Scale Why It Matters
Serotonin TUI 16 modules, 4,841 lines Full product, not just config
Pack System 14 packs with install/aliases/completions Marketplace-ready modular architecture
dotfiles.download Branded domain, one-line install Built-in distribution channel
Cross-platform macOS + Linux + Containers + Codespaces Wide addressable market
Benchmark + Doctor Diagnostic and performance tools Unique differentiator vs all competitors
Install automation Preflight checks, interactive setup, profiles Production-grade onboarding
Sheldon + zsh-defer Sub-200ms shell startup Performance story for marketing

Product Vision

dotfiles.download — Visual Developer Environment Configurator

A web-based tool where developers assemble their terminal environment visually, then get a fully working dotfiles repo with one-line install.

dotfiles.download (web)
│
├── 1. Pick shell         → zsh / bash / fish
├── 2. Pick tools         → starship / oh-my-posh / powerlevel10k
│                         → mise / asdf / nvm+pyenv
│                         → sheldon / zinit / oh-my-zsh
├── 3. Pick packs         → docker, k8s, aws, node, python, rust, ai...
├── 4. Configure          → editor, theme, keybindings, git identity
│
└── 5. Output:
    ├── Personal dotfiles repo (pushed to user's GitHub)
    ├── One-line install command
    └── Serotonin CLI for ongoing management

Architecture

dotfiles.download (SaaS)
├── Web UI (configurator)           ← user assembles their environment
├── Generator (backend)             ← builds repo from templates + packs
├── Serotonin CLI (open source)     ← standalone TUI, works with any dotfiles
├── Pack Registry (community)       ← marketplace for packs
└── iam-dotfiles (reference impl)   ← showcase / demo repo

Monetization

Tier Price Features
Free $0 Web configurator, base packs, Serotonin CLI, community support
Pro $9/mo Premium packs (AI, security, cloud), themes, priority support, Doctor Online
Team $29/seat/mo Blessed configs, onboarding automation, compliance policies, team dashboard
Enterprise Custom SSO, policy enforcement, audit logs, Codespaces/DevPod integration

Revenue Projections (Conservative)

Phase Timeline MRR Target Source
Phase 1 0-3 mo $0 Open source growth, GitHub Sponsors
Phase 2 3-9 mo $500-2,000 Pro subscriptions, GitHub Sponsors
Phase 3 9-18 mo $5,000-20,000 Team tier early adopters
Phase 4 18+ mo $20,000+ Enterprise contracts

B2B math: 1 enterprise client × 200 seats × $29/seat = $5,800/mo from a single contract.


Market Analysis

Why Now

  1. Developer Experience (DX) is the hottest topic in engineering leadership
  2. Platform Engineering is the fastest-growing role in IT (Gartner: 80% of orgs will have by 2026)
  3. Remote/async work makes standardized dev environments critical
  4. Cloud IDEs (Codespaces, Gitpod, DevPod) all support dotfiles repos but have no tooling layer
  5. AI tools are creating new terminal workflows that need configuration (Claude Code, Copilot CLI, aider)

Competitive Landscape

Tool What It Does Gap
chezmoi Template-based dotfiles manager No TUI, no packs, no web UI
yadm Git-based dotfiles manager Simpler than chezmoi, no ecosystem
GNU Stow Symlink-based dotfiles Manual, no automation
Oh-My-Zsh Plugin framework Bloated (100+ files on startup), no management TUI
Nix Home Manager Declarative system config Steep learning curve, niche audience
dotfiles.download Full platform: configure → install → manage Nothing like this exists

Target Users

Segment Pain Point Solution
Individual developers "My terminal setup took 3 days" Web configurator → instant setup
Team leads "Every dev has different tools/versions" Team tier → blessed configs
Platform engineers "Onboarding takes 2 days" Enterprise → serotonin join <team> in 5 min
Content creators "I need a shareable terminal setup" Export/import configs, pack sharing

Execution Plan

Phase 1: Open Source Fame (Months 0-3)

Goal: 2,000+ GitHub stars on Serotonin

1.1 Extract Serotonin as Standalone CLI

  • New repo: github.com/xxx/serotonin
  • Works with ANY dotfiles, not just iam-dotfiles
  • Install: brew install serotonin
  • Killer command: serotonin init → interactively creates dotfiles from scratch
  • Killer command: serotonin doctor → diagnoses any shell environment
  • Killer command: serotonin bench → benchmarks shell startup

1.2 Marketing Blitz

  • Hacker News post: "I built a TUI for managing developer environments"
  • Reddit: r/unixporn, r/commandline, r/zsh, r/terminal, r/devops
  • Dev.to / Hashnode: 3-5 article series on terminal performance
  • Twitter/X thread: "Why your shell starts in 2 seconds (and how to hit 200ms)"
  • Product Hunt launch for Serotonin CLI

1.3 Killer README + Demos

  • VHS-recorded terminal demos (infrastructure already exists)
  • "Before/After" comparison GIFs
  • Benchmark charts: "200ms startup — here's how"
  • One-command demo: curl -sL dotfiles.download/demo | bash

1.4 Pack Ecosystem Seeding

  • Publish all 14 packs as standalone, installable units
  • Write contribution guide for community packs
  • Reach out to tool authors (e.g., "we made a pack for your CLI tool")

Phase 2: Product (Months 3-9)

Goal: dotfiles.download MVP + first paying users

2.1 Web Configurator

  • Next.js + API backend
  • Visual tool/pack selection with live terminal preview
  • GitHub OAuth → creates repo in user's account
  • One-line install printed at the end

2.2 Dotfiles Doctor Online

  • Upload your dotfiles → get a diagnostic report
  • "Your shell starts in 847ms. Here's how to hit 200ms."
  • Shareable score badge (viral loop)
  • Free tool that drives traffic to the platform

2.3 Pack Marketplace

  • Community-contributed packs with review/rating
  • Install count as social proof
  • Categories: languages, cloud, security, AI, productivity

2.4 Monetization Start

  • GitHub Sponsors (immediately)
  • Pro tier launch ($9/mo): premium packs, themes, Doctor reports

Phase 3: Business (Months 9-18)

Goal: B2B revenue from Team/Enterprise tiers

3.1 Dotfiles for Teams

  • Platform Engineer creates "blessed config" for their org
  • New developer runs serotonin join <team> → full environment in 2 minutes
  • Compliance: required security packs, banned tools, mandatory settings
  • Dashboard: who's updated, who has issues, drift detection

3.2 Cloud IDE Integration

  • GitHub Codespaces already supports dotfiles repos → become the standard engine
  • Gitpod, Coder, DevPod partnerships
  • Pre-built environments: "Python Data Science", "Full-Stack Node", "Platform Engineer"

3.3 Enterprise Sales

  • Target: Platform Engineering teams at companies with 100-1,000 developers
  • Pitch: "Onboard a developer in 5 minutes instead of 2 days"
  • Features: SSO, audit logs, policy enforcement, change management

Risks and Mitigations

Risk Likelihood Impact Mitigation
Low adoption of Serotonin CLI Medium High Focus on killer demo + HN/Reddit launch; solve universal pain (slow shell)
Someone builds this first Low High Move fast; 80% of code already exists
Web configurator too complex to build Medium Medium Start with simple MVP (just pack selection → repo generation)
Enterprise sales cycle too long High Medium Focus on self-serve Team tier first; enterprise comes from inbound
Maintaining compatibility across shells/OS Medium Medium Already solved — cross-platform support is a current strength
Community packs are low quality Medium Low Curation + review process + quality badges

Immediate Next Step

Extract Serotonin into a standalone repository.

This single action transforms an internal tool into an open-source product. Everything else — the web platform, the marketplace, the B2B play — builds on top of Serotonin as an independent, installable CLI.

The iam-dotfiles repo becomes the "reference implementation" — a showcase of what Serotonin can do, not the product itself.


Key Metrics to Track

Phase Metric Target
1 GitHub stars (Serotonin) 2,000
1 Hacker News front page 1 post
1 CLI installs (brew analytics) 500
2 dotfiles.download monthly visitors 10,000
2 Repos generated via configurator 1,000
2 Pro subscribers 50-200
3 Team tier customers 5-10
3 Enterprise pipeline 3+ conversations