52 lines
1.2 KiB
Markdown
52 lines
1.2 KiB
Markdown
|
# Extra Assets
|
||
|
|
|
||
|
|
Runtime assets deployed alongside the Flutter app. Not bundled into the binary — loaded from disk at runtime via paths in `config.json`.
|
||
|
|
|
||
|
|
## Structure
|
||
|
|
|
||
|
|
```
|
||
|
|
extra/
|
||
|
|
├── fonts/ # Custom fonts (TTF/OTF)
|
||
|
|
├── images/ # Static images
|
||
|
|
│ └── navigator/ # Navigator character sprites
|
||
|
|
│ └── {name}/ # Folder per navigator (e.g., "zumo", "rei")
|
||
|
|
│ ├── default.png
|
||
|
|
│ ├── happy.png
|
||
|
|
│ ├── surprise.png
|
||
|
|
│ └── ...
|
||
|
|
└── themes/ # Color theme definitions
|
||
|
|
```
|
||
|
|
|
||
|
|
## Themes
|
||
|
|
|
||
|
|
JSON files defining dark/bright color schemes. Converted to Dart by `scripts/generate_theme.py`.
|
||
|
|
|
||
|
|
### Format
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"dark": {
|
||
|
|
"background": "#101010",
|
||
|
|
"foreground": "#EAEAEA",
|
||
|
|
"highlight": "#FA1504",
|
||
|
|
"subdued": "#E47841"
|
||
|
|
},
|
||
|
|
"bright": {
|
||
|
|
"background": "#E47841",
|
||
|
|
"foreground": "#202020",
|
||
|
|
"highlight": "#F0F0F0",
|
||
|
|
"subdued": "#BC4600"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### Adding a Theme
|
||
|
|
|
||
|
|
1. Create `extra/themes/yournavigator.json`
|
||
|
|
2. Set `"navigator": "yournavigator"` in `pi/ui/config.json`
|
||
|
|
3. Build — `generate_theme.py` picks it up automatically
|
||
|
|
|
||
|
|
### Fallback Chain
|
||
|
|
|
||
|
|
`{navigator}.json` → `default.json` → hardcoded defaults
|