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.

2.5 KiB

Raw Blame History

quotesdb — Architecture

Component Overview

Component	Path	Description
API binary	`src/bin/api/main.rs`	Rust/Axum backend on Cloudflare Workers. Handles all data operations via SQLx and Cloudflare D1.
UI binary	`src/bin/ui/main.rs`	Yew (Rust/Wasm) frontend on Cloudflare Pages. Communicates with the API over HTTP.
Shared library	`src/lib.rs`	Types and utilities shared between api and ui binaries. Must compile for both host and wasm32.
Integration tests	`tests/`	Standard Cargo integration tests. Spin up the API against in-memory SQLite and make real HTTP requests.
Infra	`infra/`	OpenTofu configuration for Cloudflare Worker, D1 database, and Pages project.

Component Interactions

Browser
  └──> Cloudflare Pages (ui binary compiled to Wasm)
         └──> Cloudflare Workers (api binary)
                └──> Cloudflare D1 (SQLite)

The UI is a static Wasm bundle served from Cloudflare Pages. It makes fetch requests to the Worker API, which reads and writes to a D1 database bound to the Worker.

Integration tests bypass the UI and talk directly to the API over HTTP, using a local in-memory SQLite database.

Build Targets

Artifact	Command	Compile target
API server	`cargo run` or `cargo build`	host (native)
UI Wasm bundle	`trunk serve` or `trunk build`	`wasm32-unknown-unknown`
Tests	`cargo test`	host (native)

Shared Code Constraints

src/lib.rs must compile for both wasm32-unknown-unknown (ui) and the host target (api). Avoid:

Threading primitives (std::thread, std::sync::Mutex)
Filesystem access (std::fs)
Any API that is not available in a Wasm environment

Use #[cfg(not(target_arch = "wasm32"))] and #[cfg(target_arch = "wasm32")] guards where needed.

Key Dependency Versions

Resolved versions for the UI Wasm target (scoped to [target.'cfg(target_arch = "wasm32")'.dependencies]):

Crate	Version	Notes
`yew`	`"0.22"`	Latest stable (0.22.1).
`yew-router`	`"0.19"`	Latest stable (0.19.0). Requires `yew ^0.22.0` — compatible.
`wasm-bindgen`	`"0.2"`	Compatible with `wasm-bindgen-cli 0.2.108` in the Nix dev shell.

Rationale: yew-router 0.19 explicitly requires yew ^0.22.0, making this the only correct combination with the latest stable Yew. The ^0.2 wasm-bindgen constraint in both crates is satisfied by the Nix-pinned 0.2.108.

2.5 KiB Raw Blame History