Sailbox

Urbit Gall app for learning Sail HTML generation and web development patterns.

What This Is

A minimal Gall agent that demonstrates:

• Sail HTML templating using Hoon runes
• Rudder web framework integration
• Form handling and state management
• Basic CRUD operations (add ships to a list)

Based on a stripped-down version of %pals.

Core Files

• desk/app/sailbox.hoon - Main Gall agent (97 lines)
• desk/sur/sailbox.hoon - Data structures (8 lines)
• desk/mar/sailbox/command.hoon - Command mark file (13 lines)
• desk/app/sailbox/webui/index.hoon - Sail HTML frontend (68 lines)

Installation

1. Clone this repo.

2. Boot up a ship (fakezod or moon or whatever you use).

3. Create new desk:

   |new-desk %sailbox

4. Install immediately (before any commits):

   |install our %sailbox

5. Mount to filesystem:

   |mount %sailbox

6. Copy sailbox files:

   cp -r desk/* [ship-name]/sailbox/

7. Commit the desk:

   |commit %sailbox

8. Access the web interface: Visit [ship-url]/sailbox in your browser.

Development Workflow

For iterating on sailbox code:

1. Setup sync configuration:

   cp config.example.json config.json
   # Edit config.json with your pier path (e.g., "/path/to/pier/sailbox/")

2. Start continuous sync:

   ./sync.sh

3. Make changes to files in desk/ - they sync automatically

4. Commit in dojo:

   |commit %sailbox

The sync script watches for file changes and automatically syncs them to your ship.

Learning Resources

• Sail documentation
• Sail/XML runes
• Rudder library source
• App School I