π― Burrito GenDex
v1.9.19 Β· a local card & prompt-version tracker Β· Windows Β· macOS Β· Linux (Electron)
Github link : https://github.com/NuriDerBurrito/Burrito_GenDex
Ever built a Prompt in your chat, closed it, and lost the exact prompt that made it?
Burrito GenDex is a desktop app for prompt engineers who work with prompts: every look gets a card, every iteration gets a prompt version, and nothing is ever lost to a scroll again. Split a prompt into named parts (body / facial / outfit 1 / outfit 2 / β¦), check the parts you want, and GenDex composes the final prompt string β ready to copy into your generator of choice.
Everything stays on your machine. No accounts, no telemetry, no cloud. The only network the app can ever speak is an optional, read-only update check that you can switch off with one toggle.
---
β¨ Features
ποΈ Cards & Classes
- Card grid β every card/look is a card: cover image, name, version chips, tag ribbons, stamp, and the notes you wrote when you made it.
- Class tree β organize cards in collapsible classes with colors and icons; drag a card between classes, right-click for the quick tools.
- Prompt versions β each card holds any number of versions; every version has its own image set, its own prompt parts, and a color + icon of its own. The top version is the one the card shows.
- Sorting & zoom β a ten-step zoom ladder for the grid, and sort modes that keep your wall in the order you think in.

πΌοΈ Image Management
- Per-version galleries β drag to reorder, star to set the cover, delete with a confirm, add from files or paste straight from the clipboard.
- Live preview stage β the stage follows every change; the big viewer opens any picture full-size with zoom and pan.
- Thumbnails β lightweight copies build automatically at import, so the grid never decodes a full-quality file.

βοΈ Prompt Compose
- Named parts β split the prompt into named chunks, each with an include checkbox; the composed prompt updates as you check.
- One-click copy β copy the composed string for the version you're on, ready for your generator, notebook, or download manager.
- Version switcher β compare iterations side by side and bring the winner back to the top.

π·οΈ Tags & Stamps
- Tag system β colorful, icon-supported tag ribbons with five trim shapes; filter your wall by tag, manage the palette in the tag manager.
- Stamp library β your watermark/logo collection; the top stamp rides the card, and the stamp gallery keeps every stamp you ever uploaded.

π¨ Customization
- Theme presets β 13 built-in themes (Zine Punk, Burrito, Archive, Carbon, Moss, Ember, Glacier, Ghost, Craft, Paper, Metal, and more) plus full custom color control.
- Polished UI β gradient trims, panel frames, ambient background glows and hover accents tied to your theme; a frameless titlebar of the app's own design.
- Smooth animations β pop in/out modals, sliding panels and menus (GPU-friendly, respects reduced-motion).

βΏ Accessibility & Productivity
- Right-click menus β the app's own stylized menus for cut / copy / paste (plus paste-as-link when the clipboard holds a URL), everywhere a field or a picture lives.
- Keyboard support β Ctrl+S to save, Esc closes dialogs, visible focus rings, aria-labels on icon buttons.
- Status ledger β every boot tells its story (loaded, repaired, recovered, migrated) in verdicts you can act on, never in silent default libraries.
πΎ Data Management
- Local NoSQL document database β the whole library lives in one gendex_db.nosql file: an append-only journal of JSON documents (no server, no cloud, nothing external). Every save appends only the sections that changed, so the file grows with your edits instead of being rewritten whole; a compaction pass keeps its history bounded, and a torn tail from a power cut costs exactly one line.
- One-time imports β if you arrive from an older release, its database is read once and everything it had is added into the current library (releases before 1.9.1 kept theirs in a gendex_db.sqlite SQLite file, and the oldest releases in a plain JSON file). The import is remembered inside the library so it never happens twice, and the old file is left untouched on your disk as your pre-migration backup.
- Automatic backups β every save first shelves the previous database to gendex_backups/ (the last eight are kept).
- Repair-at-load β a salvage ladder reads around BOMs, trailing junk, truncated writes and damaged seats before ever showing you a default library; a file that cannot be read is set aside, never overwritten.
- Export / Import β Settings β Data packs your entire library (database + images) into a single .zip you can carry to another machine, and reads one back the same way.
π Update Channel (optional)
- A read-only look at this repo's GitHub Releases that tells you when a newer version exists. It sends nothing about you or your library, and it can be turned fully OFF β after which the app never touches a network again.
---
π¦ Data Seats
The app writes only inside its own user-data folder, wherever your platform keeps it:
| Platform | Seat |
| --- | --- |
| Windows | %APPDATA%\Burrito GenDex |
| macOS | ~/Library/Application Support/Burrito GenDex |
| Linux | ~/.config/Burrito GenDex |
Inside it:
- gendex_db.nosql β the whole library (cards, classes, tags, stamps, settings), as an append-only document journal.
- gendex_db.sqlite β the pre-1.9.1 database, kept untouched on your disk after the one-time translation (delete it whenever you are happy with the new library).
- gendex_images/ β the image files you import, plus their thumbnails.
- gendex_backups/ β the last eight saved databases as a safety net.
Nothing else is written anywhere, and nothing ever leaves the machine.
---
π Getting Started
Prerequisites
- Node.js 18+
- npm
### Installation
```
# Clone the repository
git clone https://github.com/NuriDerBurrito/Burrito_GenDex.git
# Navigate to directory
cd Burrito_GenDex
# Install dependencies
npm install
# Run in development mode
npm start
# Build for production
npm run make
```
---
π Updating to a New Version (keeps your database)
Your database is stored outside the app's install folder (see the seats above), so an update never touches your data:
1. (Optional but wise) Back up: copy the whole user-data folder somewhere safe.
2. Build (or download) the new version's installer and run it.
3. Launch the app β all your classes, cards, versions, images, tags and stamps are still there.
> The app id must stay the same across versions (it already does) so the
> installer updates the existing install instead of creating a duplicate.
If you are upgrading from an older release/pre-release beta, the first launch of the new version translates your existing database into the NoSQL document store once β you will see one verdict at boot telling you so β and the old file gendex_db.sqlite, or gendex_db.json from beta) stays on your disk, untouched, until you choose to delete it.
---
ποΈ Uninstalling
- App only (keeps your database): Windows Settings β Apps β Burrito GenDex β Uninstall (or run the uninstaller the installer left in your local app programs folder).
- Everything including your database: after uninstalling the app, also delete the user-data folder named in the table above.
---
π Usage
Creating a character
1. Click the + seat and name the character (or pick its class first from the tree).
2. Add images: from files, or paste straight from the clipboard; star the one that should be the cover.
3. Tag it, stamp it, and write the notes you'll want when you come back.
Building the prompt
1. Open the character and add a version (or several β one per look).
2. Split the prompt into named parts (body, facial, outfitβ¦) and fill each in.
3. Check the parts you want; the composed prompt updates live β one click copies it.
Keeping what worked
- Reorder versions so the winner sits on top; every version keeps its own images and its own parts.
- Export the whole library as a .zip before any big machine move; import it back on the other side.
---
π₯οΈ Platform Support
Burrito GenDex is available for:
- Windows β built with a Squirrel installer
- macOS β (npm install)
- Linux β available as DEB and RPM packages
> Note: Building for each platform requires running the build process on that respective operating system.
---
π οΈ Built With
- [Electron] desktop application framework
- [React] UI library
- [Tailwind CSS] styling
- [Lucide Icons] icon set
- [sql.js] SQLite , the one-time translation reader for pre-1.9.1 libraries (WebAssembly build, embedded in the app); the live store is the app's own document engine src/utils/nosql_engine.js)
---
π§ͺ Development
The tree carries the regression battery (93 DOM/source test suites) β run it from the app root:
```
bash scripts/run_battery_171.sh
```
Syntax and CSS gates for the touched seats:
```
node scripts/parse_check.mjs src/App.jsx src/components/SettingsModal.jsx
node scripts/css_check.cjs src/index.css
```
---
π License
This project is licensed under the MIT License.
---
π Acknowledgments
- [Duskfallcrew] beta tester: installed and tested the product before release, pointed out vulnerabilities and bugs, and celebrated every fix. The About wall keeps a key for them.
---
π¬ Contact

- Discord: nuriderburrito
- GitHub: [NuriDerBurrito]
- HuggingFace: [NuriDerBurrito]
- Website: [Genesis Iterations]
---
Feel free to add suggestions and report issues!




