Files
ps1-craft/libary.md
2026-01-24 18:58:14 +00:00

294 lines
4.4 KiB
Markdown

# Theme Library
This file lists every prompt theme, color codes, design intent, and configuration options.
## Seasonal (Aurora, Standard Pack)
Design intent: calm, readable, long-session comfort with a subtle five-step gradient
(date -> time -> user -> host -> path).
Layout: two-line powerline, host+path on line 1, status + emoji on line 2.
Winter:
```
Z1_BG=59 Z2_BG=61 Z3_BG=63 Z4_BG=38 Z5_BG=37
Z1_FG=255 Z2_FG=255
PATH_FG=152
FRAME=60
```
Spring:
```
Z1_BG=68 Z2_BG=70 Z3_BG=72 Z4_BG=121 Z5_BG=120
Z1_FG=255 Z2_FG=22
PATH_FG=28
FRAME=65
```
Summer:
```
Z1_BG=141 Z2_BG=142 Z3_BG=143 Z4_BG=214 Z5_BG=208
Z1_FG=255 Z2_FG=0
PATH_FG=0
FRAME=130
```
Autumn:
```
Z1_BG=93 Z2_BG=95 Z3_BG=97 Z4_BG=166 Z5_BG=136
Z1_FG=255 Z2_FG=255
PATH_FG=223
FRAME=95
```
Seasonal preview (Aurora):
![Aurora](./images/themes/aurora.png)
## Contest Pack (style_pack=contest)
Design intent: high-contrast silhouettes, fast scanning, stage-ready presence.
Layout: configurable order for the left segment, always ends with "@host - /path".
Aurora (contest palette):
```
Z1_BG=24 Z2_BG=31
Z1_FG=255 Z2_FG=255
PATH_FG=51
FRAME=23
```
Aurora (contest) preview:
![Aurora (contest)](./images/themes/aurora.png)
Neon:
```
Z1_BG=201 Z1_FG=255
Z2_BG=45 Z2_FG=16
PATH_FG=16
FRAME=199
```
![Neon](./images/themes/neon.png)
Forge:
```
Z1_BG=94 Z1_FG=230
Z2_BG=166 Z2_FG=231
PATH_FG=224
FRAME=130
```
![Forge](./images/themes/forge.png)
Circuit:
```
FG_MAIN=46
FG_DIM=22
PATH_FG=120
```
![Circuit](./images/themes/circuit.png)
Mono:
```
FG_MAIN=250
FG_DIM=240
```
![Mono](./images/themes/mono.png)
Git:
```
Z1_BG=61 Z1_FG=255
Z2_BG=37 Z2_FG=255
PATH_FG=194
FRAME=60
```
![Git](./images/themes/git.png)
Hawolex:
```
Z1_BG=54 Z1_FG=255
Z2_BG=31 Z2_FG=255
PATH_FG=230
FRAME=24
```
![Hawolex](./images/themes/hawolex.png)
HawolexV2 (gradient):
```
Z1_BG=54 Z2_BG=55 Z3_BG=56 Z4_BG=31 Z5_BG=30
Z_FG=255
PATH_FG=230
FRAME=24
```
HawolexV2 preview: image pending
Demo:
```
Cycles all themes on each prompt (screenshots mode).
```
## Holidays Pack (style_pack=holiday)
Design intent: themed color + emoji without sacrificing readability.
Layout uses contest order and ends with "@host - /path".
Christmas:
```
Z1_BG=52 Z2_BG=28
Z1_FG=255 Z2_FG=255
PATH_FG=194
FRAME=88
```
![Christmas](./images/themes/christmas.png)
Easter:
```
Z1_BG=186 Z2_BG=150
Z1_FG=16 Z2_FG=16
PATH_FG=94
FRAME=143
```
![Easter](./images/themes/easter.png)
Halloween:
```
Z1_BG=53 Z2_BG=166
Z1_FG=255 Z2_FG=16
PATH_FG=16
FRAME=89
```
![Halloween](./images/themes/halloween.png)
Valentine:
```
Z1_BG=198 Z2_BG=205
Z1_FG=255 Z2_FG=255
PATH_FG=224
FRAME=162
```
![Valentine](./images/themes/valentine.png)
Thanksgiving:
```
Z1_BG=94 Z2_BG=136
Z1_FG=230 Z2_FG=231
PATH_FG=223
FRAME=130
```
![Thanksgiving](./images/themes/thanksgiving.png)
NewYear:
```
Z1_BG=17 Z2_BG=20
Z1_FG=255 Z2_FG=255
PATH_FG=229
FRAME=19
```
![NewYear](./images/themes/newyear.png)
## Custom Pack (style_pack=custom)
Design intent: experimental, high-signal styles with bold contrast and distinct silhouettes.
Custom styles include a context badge when relevant (ssh, ctr, git).
Radar:
```
FRAME=22
FG_MAIN=46
FG_DIM=28
PATH_FG=120
```
![Radar](./images/themes/radar.png)
Synthwave:
```
Z1_BG=198 Z1_FG=255
Z2_BG=45 Z2_FG=16
Z3_BG=208 Z3_FG=16
FRAME=201
```
![Synthwave](./images/themes/synthwave.png)
Noir:
```
FG_MAIN=250
FG_DIM=242
PATH_FG=160
FRAME=236
```
![Noir](./images/themes/noir.png)
Topo:
```
PATH_FG_LIST=109,110,111,110
FRAME=24
```
![Topo](./images/themes/topo.png)
Glitch:
```
FG_MAIN=118
FG_DIM=60
FRAME=129
```
![Glitch](./images/themes/glitch.png)
ArcticFire:
```
Z1_BG=24 Z1_FG=255
Z2_BG=31 Z2_FG=255
Z3_BG=208 Z3_FG=16
FRAME=25
```
![ArcticFire](./images/themes/arcticfire.png)
AcidLime:
```
FG_MAIN=46
FG_DIM=40
PATH_FG=118
FRAME=46
```
![AcidLime](./images/themes/acidlime.png)
## Configuration Options
Core:
```
PS1_STYLE_PACK=standard|contest|holiday|custom
PS1_STYLE=aurora|neon|forge|circuit|mono|git|hawolex|hawolexv2|radar|synthwave|noir|topo|glitch|arcticfire|acidlime|demo
PS1_SEASON_MODE=dynamic|static
PS1_SEASON=winter|spring|summer|autumn
PS1_CONTEST_LAYOUT=day-time-user|user-time|time-user|day-time
PS1_HOLIDAY=christmas|easter|halloween|valentine|thanksgiving|newyear
PS1_GIT=0|1
```
Overrides:
```
PS1_FORCE_NF=1 # force Nerd Font separators
PS1_FORCE_ASCII=1 # force ASCII/Unicode separators
DISABLE_GLOBAL_PS1=1 # disable prompt in current shell
~/.config/ps1/disable # disable prompt per-user
```