Skip to content

docs: update README for auto-generated settings (#40)#43

Merged
grunch merged 1 commit into
mainfrom
docs/update-readme-first-run
Mar 19, 2026
Merged

docs: update README for auto-generated settings (#40)#43
grunch merged 1 commit into
mainfrom
docs/update-readme-first-run

Conversation

@mostronatorcoder

Copy link
Copy Markdown
Contributor

Summary

Updates README documentation to reflect the new first-run behavior implemented in PR #41.

Changes

Settings section rewritten

Before: README said Mostrix copies settings.toml from project root to ~/.mostrix/ on first run, requiring manual editing beforehand.

After: Documents the new zero-config experience:

  • Fresh Nostr keypair auto-generated
  • Sensible defaults applied:
    • relays = ["wss://relay.mostro.network"]
    • user_mode = "user"
    • pow = 0
    • currencies_filter = [] (all currencies)
    • Official Mostro pubkey pre-configured
  • Generated npub printed to stdout
  • 0600 file permissions on Unix

Configuration priority documented

  1. ~/.mostrix/settings.toml — User config directory
  2. settings.toml next to executable — Portable mode (USB installs)
  3. Auto-generate — If neither exists

Example settings.toml updated

  • Removed misleading placeholder values
  • Shows actual defaults
  • Added note about auto-generation

TODO list

Related

Updates documentation to reflect the new first-run behavior implemented
in PR #41:

## Changes

### Settings section rewritten
- Documented zero-config first run experience
- Listed auto-generated defaults (keypair, relay, user_mode, etc.)
- Explained configuration priority (user dir > portable > auto-generate)
- Added note about 0600 file permissions on Unix

### Example settings.toml updated
- Removed placeholder values that suggested manual editing
- Shows actual defaults used by auto-generation
- Added note explaining values are auto-generated

### TODO list
- Marked auto-generate feature as complete with issue link

## Related
- Closes #40 (via PR #41)
- Documents behavior from PR #41
@grunch grunch merged commit 380f662 into main Mar 19, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Auto-generate settings.toml with sensible defaults on first run

1 participant