Polish README and update state JSONs
This commit is contained in:
@@ -10,14 +10,9 @@
|
|||||||
"main": {
|
"main": {
|
||||||
"notes": [
|
"notes": [
|
||||||
"Shared PS1 module in dotfiles/ps1/ps1.sh is source of truth for both Linux and macOS installers.",
|
"Shared PS1 module in dotfiles/ps1/ps1.sh is source of truth for both Linux and macOS installers.",
|
||||||
"README documents 4seasons branch, seasonal ranges, static/dynamic choice.",
|
"README documents seasonal ranges and style packs.",
|
||||||
"README example image uses images/bash-pallete.png."
|
"README example image uses images/bash-pallete.png."
|
||||||
]
|
]
|
||||||
},
|
|
||||||
"dev": {
|
|
||||||
"notes": [
|
|
||||||
"Development branch; currently in sync with main."
|
|
||||||
]
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"files": {
|
"files": {
|
||||||
|
|||||||
92
README.md
92
README.md
@@ -1,15 +1,23 @@
|
|||||||
# Bashrc Dotfiles — Global & Portable Bash Prompt
|
# Bashrc Dotfiles — Global & Portable Bash Prompt
|
||||||
|
|
||||||
Production-ready on `main`.
|
Elegant, portable, and easy-to-install Bash prompt with seasonal palettes, time-aware emoji, and clean powerline structure.
|
||||||
|
|
||||||
Elegant, portable, and easy-to-install Bash prompt with:
|
---
|
||||||
|
|
||||||
- ✨ Two color zones
|
## ✅ Requirements (Nerd Fonts)
|
||||||
- 🌅 Time-based emoji accents
|
|
||||||
- 🖥️ Fallback when Nerd Fonts aren’t available
|
This prompt relies on Nerd Font glyphs for the rounded separators.
|
||||||
- 📍 Shortened but informative path
|
|
||||||
- 🔘 Status-colored prompt arrow
|
```bash
|
||||||
- 🧠 Works on Linux, WSL, and macOS
|
bash dotfiles/install/install-nerdfont.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
After install:
|
||||||
|
|
||||||
|
- Set your terminal font to JetBrainsMono Nerd Font (or any Nerd Font)
|
||||||
|
- Manual download: https://www.nerdfonts.com/font-downloads
|
||||||
|
|
||||||
|
If you use a non‑Nerd font, the prompt falls back to ASCII/Unicode.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -63,21 +71,6 @@ bash dotfiles/install/install-macos-user.sh
|
|||||||
source ~/.bashrc
|
source ~/.bashrc
|
||||||
```
|
```
|
||||||
|
|
||||||
### 🖼️ Nerd Fonts (optional but recommended)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
bash dotfiles/install/install-nerdfont.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
After install:
|
|
||||||
|
|
||||||
- Open your terminal settings
|
|
||||||
- Set font to JetBrainsMono Nerd Font (or any Nerd Font)
|
|
||||||
- Terminal must use a Nerd Font for glyphs like ``, ``, `` to render correctly
|
|
||||||
- Manual download: https://www.nerdfonts.com/font-downloads
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary><strong>Installer choices</strong></summary>
|
<summary><strong>Installer choices</strong></summary>
|
||||||
|
|
||||||
@@ -95,6 +88,17 @@ macOS:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## ✨ Features
|
||||||
|
|
||||||
|
- Two-line, powerline-style prompt
|
||||||
|
- Seasonal palettes + time-based emoji accents
|
||||||
|
- Smart path shortening (keeps home visible)
|
||||||
|
- Status-colored prompt arrow
|
||||||
|
- Works on Linux, WSL, and macOS
|
||||||
|
- Per-user disable switch
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary><strong>What gets installed</strong></summary>
|
<summary><strong>What gets installed</strong></summary>
|
||||||
|
|
||||||
@@ -151,19 +155,6 @@ echo "Your punchline" | sudo tee /etc/ps1-punchline >/dev/null
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🧠 Features
|
|
||||||
|
|
||||||
- **Clean, modern powerline-style prompt**
|
|
||||||
- Zone 1: date/time/user (cool gray-blue)
|
|
||||||
- Zone 2: host/path (turquoise / cool green)
|
|
||||||
- Automatically switches emoji during the day
|
|
||||||
- Smart path shortening (keeps your home dir visible)
|
|
||||||
- Fallback to ASCII/Unicode if Nerd Fonts are not installed
|
|
||||||
- Per-user disable support
|
|
||||||
- Simple per-user or global install
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎛️ Themes & Style Packs
|
## 🎛️ Themes & Style Packs
|
||||||
|
|
||||||
### 🏁 Contest Pack
|
### 🏁 Contest Pack
|
||||||
@@ -223,6 +214,15 @@ Holidays pack uses themed palettes + emojis and the contest layout order:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## 🧭 Theme Design Notes
|
||||||
|
|
||||||
|
- **Aurora (seasonal):** calm hierarchy, subtle gradients, long-term readability
|
||||||
|
- **Contest styles:** bold contrast and distinct silhouettes for instant recognition
|
||||||
|
- **Custom pack:** experimental, high-signal variants for strong personal style
|
||||||
|
- **Holidays:** themed colors + emojis without compromising legibility
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary><strong>Emoji palette</strong></summary>
|
<summary><strong>Emoji palette</strong></summary>
|
||||||
|
|
||||||
@@ -373,26 +373,6 @@ Current combined palette reference:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔥 Why this is real high-end PS1 design
|
|
||||||
|
|
||||||
- Semantic color use (identity vs location)
|
|
||||||
- Few colors, but with meaning
|
|
||||||
- Path is visible, but never dominant
|
|
||||||
- Emoji is an accent, not a gimmick
|
|
||||||
- Prompt line is calm → the command gets focus
|
|
||||||
|
|
||||||
### 🎨 Color palette (notes)
|
|
||||||
|
|
||||||
| Role | BG | Description |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| Zone 1 BG | 61 | gray-blue pastel |
|
|
||||||
| Zone 1 FG | 255 | pure white |
|
|
||||||
| Zone 2 BG | 37 | turquoise / cool green |
|
|
||||||
| Path FG | 194 (FG) | light green, muted |
|
|
||||||
| Frame | 60 | darker blue |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🛠️ Contribution
|
## 🛠️ Contribution
|
||||||
|
|
||||||
Want to help improve this project?
|
Want to help improve this project?
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"project": "Bashrc Dotfiles",
|
"project": "Bashrc Dotfiles",
|
||||||
"branch": "dev",
|
"branch": "main",
|
||||||
"purpose": "DEFCON contest + custom render pack for PS1 styles",
|
"purpose": "DEFCON contest + custom render pack for PS1 styles",
|
||||||
"contest_pack": {
|
"contest_pack": {
|
||||||
"layout_options": [
|
"layout_options": [
|
||||||
|
|||||||
Reference in New Issue
Block a user