You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Micro static-site host running entirely on Cloudflare: a Rust->wasm Worker (workers-rs 0.7 + axum 0.8) serving user-uploaded .html/.zip content from R2 at pages.elijah.run/<slug>/, with D1 for users/ sessions/page metadata and GitHub OAuth for login. Admins approve uploaders, delete pages, and can mark pages/users trusted. Security design (docs/plans/2026-07-12-pages-design.md): hosted content is served with a CSP sandbox (opaque origin — no cookies or storage, cannot make credentialed /api calls) unless admin-trusted; strict slug grammar + reserved names; streaming zip validation (traversal, bombs, size/entry/depth limits); SHA-256-hashed session tokens in __Host- cookies; Origin checks on all mutations; upload quotas and size caps. Includes OpenTofu infra (R2, D1, DNS; wrangler owns the Worker deploy), an embedded single-file management UI, deployment guide, and 148 native unit tests + 18 doctests (clippy -D warnings clean on native and wasm32). Deployed and verified in production. Squash of 15 commits from pages-v0: each ticket implemented by a Claude Sonnet agent, reviewed by a Claude Opus agent, tracked with beans (pages-lxjz..pages-shqc). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> |
1 week ago | |
|---|---|---|
| .beans | 4 months ago | |
| .claude | 4 months ago | |
| .gitea/workflows | 4 months ago | |
| edu | 4 months ago | |
| pages | 1 week ago | |
| quotesdb | 4 months ago | |
| scripts | 4 months ago | |
| .beans.yml | 4 months ago | |
| .envrc | 5 months ago | |
| .gitattributes | 5 months ago | |
| .gitignore | 5 months ago | |
| CLAUDE.md | 4 months ago | |
| LICENSE-APACHE | 5 months ago | |
| LICENSE-MIT | 5 months ago | |
| PROJECTS.md | 4 months ago | |
| README.md | 1 week ago | |
| TODO.md | 5 months ago | |
| flake.lock | 4 months ago | |
| flake.nix | 4 months ago | |
README.md
Vibed
A mono-repo of CLI tools and self-contained HTTP web services built in Rust, targeting Cloudflare's edge platform.
- Backend services run on Cloudflare Workers (via workers-rs + Axum).
- Frontend applications compile to Wasm with Yew and deploy to Cloudflare Pages.
- Data is stored in Cloudflare D1 (SQLite-compatible), with Turso for local development.
- Infrastructure is managed with OpenTofu and the Cloudflare provider.
Services
| Service | Description |
|---|---|
common |
Shared library crate — types, utilities, and definitions used across services |
pages |
Micro static-site host at pages.elijah.run — upload an .html/.zip, served sandboxed at /<name>/ (Cloudflare Workers + R2 + D1, Rust→wasm, GitHub OAuth) |
Services will be listed here as they are added.
Getting Started
Prerequisites
- Nix with Flakes enabled
Setup
# Clone the repository
git clone https://gitea.elijah.run/pop/vibed.git
cd vibed
# Enter the dev shell (installs Rust, Trunk, OpenTofu, wrangler, etc.)
nix develop
The dev shell provides everything needed to build, test, and deploy all services.
Running a Service
# Backend
cd <service>
cargo run
# Frontend
cd <service>
trunk serve
Validation
Run from within a service directory, in order:
cargo fmt # formatting
cargo check # compilation
cargo clippy # lints
cargo test # tests
Repository Layout
vibed/
├── CLAUDE.md # conventions and instructions for Claude Code
├── README.md # this file
├── LICENSE-APACHE
├── LICENSE-MIT
├── flake.nix # base Nix flake
├── common/ # shared library crate
└── <service>/ # each service is an independent Rust crate
├── src/
├── tests/ # integration tests
├── docs/ # PLANNING.md, ARCHITECTURE.md
└── infra/ # OpenTofu infrastructure
See CLAUDE.md for full conventions, code style, and project documentation requirements.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Disclaimer
This software is developed with the assistance of Claude Code by Anthropic.