The skeleton, not features. Two things felt rushed: the colour had no point of view, and type and shape came from ad-hoc values. Design language - Palette reworked to warm-neutral dark with a single muted gold accent (#d9a441). The chrome is deliberately colourless because the artwork is the colour in this app; gold carries emphasis without competing with covers. Light mode re-tuned to match. - A real type scale (--fs-xs … --fs-3xl) replaces the ad-hoc rem values, with fixed line heights and letter-spacing per level. Headings are 620 weight and tighter; body is a consistent 15px. - Radii tightened to a 5/8/12 scale, one shadow pair, and the primary button now uses dark ink on gold for contrast. Featured carousel - The banner rotates through up to six items — in progress first, then most viewed, then newest — drawn only from the libraries the user was granted, so it can never show something they cannot open. - Auto-advances every 8s, pauses on hover and focus, and has dots plus arrows for manual control. Slides crossfade, and the ambient wash changes with them. Verified in the built bundle: accent resolves to #d9a441, six slides, rotation confirmed across three items, and hover pauses it. |
||
|---|---|---|
| .. | ||
| src | ||
| .gitignore | ||
| embed.go | ||
| index.html | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| svelte.config.js | ||
| tsconfig.json | ||
| vite.config.ts | ||
Vellum web
Svelte 5 + Vite + TypeScript single-page app. It is built to a static bundle in
dist/ and embedded into the Go binary, so all asset paths are relative
(base: './' in vite.config.ts).
Commands
pnpm install
pnpm dev # dev server on :5173, proxying /api to :7788
pnpm build # writes dist/
pnpm check # svelte-check
Run the Go server on :7788 (make run from the repo root) and pnpm dev
proxies API and health requests to it, so cookies and sessions behave exactly
as they will in production.
Layout
src/
main.ts entry point
App.svelte login gate -> shell
app.css design tokens and base styles
lib/
api.ts typed client; mirrors the Go handlers
session.ts auth + library stores
nav.ts view state
components/
Login.svelte
Shell.svelte nav + view switch
Libraries.svelte library list, create, scan, delete
LibraryView.svelte item grid with covers
Reader.svelte epub.js reader with progress sync
Users.svelte admin user management
The reader resumes from a spine index, which is why progress positions are
integers: it round-trips through the polymorphic progress table without
needing a text column.