Use real public-domain photos throughout (Chicago skyline, CTA signage, Marina City, Union Station, guitars, synths, cassette, Game Boy and floppy stickers, daisies, clouds, flowers, a vintage postcard and stamp), credited on a new /credits page. Lean into Chicago: CTA 'L' line colors for sections and categories, a Chicago star logo, flag footer, a CTA platform work page with split-flap board and arrival rows, and a Greetings from Chicago postcard on contact. Add GSAP + Lenis scroll motion and React Bits components (split-flap, ticker, circular badge, count-up, sticker peel, scrambled text, halftone reveal, CRT terminal, staggered mobile menu). Rebuild pages mobile-first, drop the katakana, and lazy-load the 3D viewer.
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, drawn from 80s–90s print and retro-tech references, tied together by
Chicago: every section and project category rides a CTA 'L' line color (src/lib/disciplines.ts,
--cta-* tokens), and the footer carries the Chicago flag.
| Theme | Used on | Feel |
|---|---|---|
magazine (default) |
Home | Maximalist magazine cover: photo collage, stickers, cover lines |
transit |
Work index | CTA platform: station sign, split-flap board, arrival rows |
spec |
Project pages, credits | Technical exhibition poster |
desktop |
Blog, 404 | 90s desktop windows, pixelated photo wallpaper |
radio |
Music | Radio flyer, halftone photo, dot-matrix type |
vector |
3D models | CRT terminal, wireframe cube, data panels |
garden |
About | Daisies, cream blobs, seed packets |
postcard |
Contact | "Greetings from Chicago" postcard + stamp |
terminal |
(available) | Green-phosphor CRT |
- Tokens:
src/styles/tokens.css. Themes:src/styles/themes/*.css(semantic tokens only). - Pick a theme:
<Base theme="radio">, ortheme: vectorin a project/post's frontmatter. - Mixed media:
src/components/deco/—Clipping(real photo with tape / tilt / duotone / riso / halftone / torn edge),Starburst,Barcode,Window,Stamp; plusChicagoStar,LineBadge. - Photos:
src/assets/photos/— all CC0 / public domain via Openverse, listed insrc/data/photo-credits.jsonand shown at/credits. Add new ones there too.
Motion
- Lenis smooth scrolling + GSAP ScrollTrigger in
src/scripts/motion.ts. Mark elements withdata-reveal(ordata-reveal="tilt"),data-reveal-staggeron a parent,data-parallax="0.2". Touch devices keep native scrolling; everything is skipped forprefers-reduced-motion. - React Bits components live in
src/components/bits/(copied source, MIT + Commons Clause — keep the header notice): SplitFlapText, ScrollVelocity, CircularText, CountUp, ScrambledText, StickerPeel, HalftoneReveal, FaultyTerminal, StaggeredMenu (mobile menu). - WebGL pieces (
HalftoneReveal,FaultyTerminal) useclient:only="react"; the 3D viewer library loads only when a model scrolls near the screen.
Mobile first
Base styles target phones; desktop layouts are added with min-width media queries. Keep tap
targets ≥ 44px, and wrap anything that overhangs inside main (which clips horizontal overflow).
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.