# config.jsonc

> **Owned by rmfmail. Do not edit this DOCUMENTATION file — changes will be overwritten.** Note: the **actual** `config.jsonc` IS user-editable; this `.md` file is just the reference for it.

## What this file documents

`config.jsonc` is your *local, per-machine* config. It is **NOT** synced to GDrive — every machine has its own. It points at the shared GDrive folder and overrides machine-specific paths.

Lives at `~/.rmfmail/config.jsonc` on the local filesystem.

## Shape

```jsonc
{
  "sharedDir": {
    "provider": "gdrive",
    "path": ".rmfmail",                            // folder name in My Drive (currently My Drive/home/.rmfmail)
    "folderId": "1AbCdEf...XYZ"                    // resolved Drive folderId, cached after first lookup
  },
  "storePath": "~/.rmfmail/mailxstore",            // local directory for .eml message bodies
  "historyDays": 30                                // how far back to sync; overrides the shared default
}
```

## Notes

- `sharedDir.provider`: `"gdrive"` is the only currently-supported value (OneDrive/Dropbox were removed).
- `sharedDir.folderId` is resolved at startup if missing; caching it avoids a Drive query on every launch.
- `storePath` is where `.eml` bodies are stored locally. Defaults to `~/.rmfmail/mailxstore` on desktop. Android uses app-private sandbox storage and ignores this field.
- `historyDays` is a per-machine override for the cloud-synced default in `preferences.jsonc`.
- Because this file is local, edits don't propagate to other devices. Use `accounts.jsonc` / `preferences.jsonc` for shared settings.
- JSONC: `// line comments` and trailing commas are allowed.
