toes/README.md

🐾 Toes

Toes is a personal web server you run in your home.

Plug it in, turn it on, and forget about the cloud.

quickstart

1. Plug in and turn on your Toes computer.
2. Tell Toes about your WiFi by <using dark @probablycorey magick>.
3. Visit https://toes.local to get started!

features

• Hosts bun/hono/hype webapps - both SSR and SPA.
• toes CLI for pushing and pulling from your server.
• toes CLI for local dev mode.
• https://toes.local web UI for managing your projects.
• Per-branch staging environments for Claude.

cli configuration

by default, the CLI connects to localhost:3000 in dev and toes.local:80 in production.

toes config                                  # show current host
TOES_URL=http://192.168.1.50:3000 toes list  # connect to IP
TOES_URL=http://mypi.local toes list         # connect to hostname

set NODE_ENV=production to default to toes.local:80.

fun stuff

• textOS (TODO, more?)
• Claude that knows about all your toes APIS and your projects.
• HTTPS Tunnel for sharing your apps with the world.
• Charts and graphs in the webUI.

february goal

• Corey and Chris are running Toes servers on their home networks, hosting personal projects and games.