toes/README.md
2026-01-30 17:00:07 -08:00

43 lines
1.3 KiB
Markdown

# 🐾 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.
```bash
toes config # show current host
TOES_URL=http://192.168.1.50:3000 toes list # full URL
TOES_HOST=mypi.local toes list # hostname (port 80)
TOES_HOST=mypi.local PORT=3000 toes list # hostname + port
```
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.