Each page now has its own look drawn from print and retro-tech references: magazine-cover home, subway-map work index, technical-poster project pages, 90s-desktop blog, radio-flyer music page, 80s wireframe 3D page, garden about page and postcard contact form. A shared subway-line color system ties sections and project categories together. Replace themed copy with standard wording (Work, Blog, Music, 3D, About, Contact; Selected work, Experience, Get in touch). Rename /log to /blog and /sound to /music with redirects.
yoyos.sh
Portfolio, project archive and weekly log of Johan Sandoval.
Stack: Astro (static pages + a small Node server) · React islands · MDX · plain CSS ·
Docker on Coolify. Large media lives on the NAS (Nextcloud) and is proxied through /media.
npm install
npm run dev # http://localhost:4321
npm run build && npm start
Deploy pipeline
push to GitHub main ──(.github/workflows/mirror.yml)──▶ Gitea yoyos/yoyos.sh ──▶ Coolify (Dockerfile) ──▶ yoyos.sh
- GitHub repo secrets:
GITEA_URL(https://gitea.yoyos.sh/yoyos/yoyos.sh.git),GITEA_TOKEN. - Coolify: Dockerfile build pack, port 4321, health check
/healthz. - Coolify environment variables: see
.env.example(MEDIA_ORIGIN,SMTP_*,CONTACT_*).
Adding content
| What | Where |
|---|---|
| Project | src/content/work/<slug>.md(x) or src/content/work/<slug>/index.mdx with images next to it |
| Blog post | src/content/blog/<slug>.md(x) (draft: true hides it in production) |
| Recording | src/content/music/<slug>.yaml + audio file in the media share under music/ |
| 3D model | src/content/models/<slug>.yaml + .glb in the media share under models/ |
| Game | add a game: block to a project + web export in the media share under games/<slug>/ → playable at /play/<slug> |
| Personal info, links, availability | src/lib/site.ts |
Every field is typed in src/content.config.ts, so the build fails loudly when something's missing.
Styling
Each page has its own look, built on one shared palette and a "subway line" color system
(every section and project category has a line color + badge, see src/lib/disciplines.ts).
| Theme | Used on | Feel |
|---|---|---|
magazine (default) |
Home | 90s magazine cover / print ad |
transit |
Work index | Subway map, transit cards |
spec |
Project pages | Technical exhibition poster |
desktop |
Blog, 404 | Late-90s desktop windows |
radio |
Music | College-radio flyer, dot-matrix type |
vector |
3D models | 80s computer graphics, wireframes |
garden |
About | Grass, cream blobs, lowercase type |
postcard |
Contact | Postcard + stamp |
terminal |
(available) | Green-phosphor CRT |
src/styles/tokens.css: raw palette (paper, ink, lime, red, cobalt, yellow, emerald...), font stacks, type scale, spacing.src/styles/themes/*.css: each theme maps the palette onto semantic tokens (--bg,--fg,--accent,--font-display, heading weight/case/width, border, shadow, grain, scanlines).- Use a theme on a page:
<Base theme="radio">, ortheme: vectorin a project/post's frontmatter (projects default tospec, posts todesktop). Use it on one section:<section data-theme="garden">. - New theme: copy a theme file, rename the selector, import it in
themes/index.css, add the name tosrc/lib/themes.ts. - Page-specific flourishes live in each page's own
<style>block (scoped automatically). - Decorative components:
src/components/deco/(Starburst, Barcode, Window, Stamp) andLineBadge.
Media share (Nextcloud)
- In Nextcloud, make a folder (e.g.
yoyos.sh-media) withmusic/,models/,games/,resume/. - Share it with a public link (read-only). The token is the last part of the link.
- Set
MEDIA_ORIGIN=https://<nextcloud-host>/public.php/dav/files/<token>in Coolify. - Files are then served from
https://yoyos.sh/media/<path>, e.g./media/resume/Johan_Sandoval_Resume.pdf.
The proxy passes range requests (audio/video seeking), sets correct types for .wasm/.glb/.pck,
adds Content-Encoding for Unity's pre-compressed .br/.gz files, and sends COOP/COEP headers
under games/. For Godot 4.3+, exporting with thread support off avoids cross-origin
isolation entirely. Threaded builds work via the "Open in new tab" button on the play page.