Zero-Config Principle #

Philosophy #

Whenever a value can be derived automatically, derive it.

Only ask the developer for information that genuinely cannot be inferred.

Auto-Derived Values #

What You Still Configure #

Only configure what cannot be derived:

# reposell.yml - minimal required
version: 1

product:
  name: "My Product"           # Required for listing
  description: "Description"   # Required for listing
  category: "developer-tools"  # Optional
  tags: ["cli", "typescript"]  # Optional

pricing:
  amount: 5000                 # In minor units (cents)
  currency: "USD"
  model: "one_time"            # one_time | subscription | pay_what_you_want

releases:
  mode: "all"                  # "selected" | "all"
  selected: []                 # Only if mode: "selected"

payment:
  provider: "stripe"           # Only "stripe" currently

listing:
  enabled: false               # Enable /listing
  auto_register: true          # Auto-register on release

git:
  provider: "github"           # Auto-detected from remote

signing:
  # Keys NEVER in config - use env/keychain
  # Private key: REPOSELL_SIGNING_KEY (env var or keychain)
  # Public key: committed to config/reposell/verification-key.pub

What You Never Configure #

❌ Never in config:

• Private keys (use env/keychain)
• Stripe secret keys (GitHub Actions secrets)
• Webhook secrets (not used - no webhooks)
• GitHub tokens (CI provides GITHUB_TOKEN)
• Repository metadata (auto-derived)
• Release lists (auto-detected from tags)

Environment Variables #

For local development only (.env.example) — optional, used solely by the terminal dashboard and sell sync; checkout itself needs no keys:

# .env (gitignored)
STRIPE_SECRET_KEY=sk_test_...
REPOSELL_SIGNING_KEY=base64_key    # Or use OS keychain

GitHub Actions Secrets #

Required secrets in repository settings:

Configuration Precedence #

1. Defaults (zero-config derivation)
2. reposell.yml (explicit config)
3. Environment variables (overrides)
4. CLI flags (highest priority)

Configuration File Discovery #

Commands look for config in order:

1. --config flag
2. REPOSELL_CONFIG env var
3. reposell.yml in current directory
4. reposell.yml in parent directories
5. .reposell.yml in home directory

Validation #

# Validate config
reposell doctor

# Auto-fix safe issues
reposell doctor --fix

Configuration Schema #

Full JSON Schema: https://reposell.dev/schemas/reposell-config-v1.json

Validate with:

npx ajv validate -s schema.json -d reposell.yml