2026-10-08 14:41:39 +00:00
2026-10-08 14:41:39 +00:00
2026-10-08 14:41:39 +00:00
2026-10-08 14:41:39 +00:00

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">, or theme: vector in 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; plus ChicagoStar, LineBadge.
  • Photos: src/assets/photos/ — Unsplash photos and Pixabay stickers/clipart, credited in IMAGE_CREDITS.md and shown at /credits. Run python3 tools/fx.py after changing a source photo to rebuild src/assets/fx/.

Motion

  • Lenis smooth scrolling + GSAP ScrollTrigger in src/scripts/motion.ts. Mark elements with data-reveal (or data-reveal="tilt"), data-reveal-stagger on a parent, data-parallax="0.2". Touch devices keep native scrolling; everything is skipped for prefers-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) use client: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)

  1. In Nextcloud, make a folder (e.g. yoyos.sh-media) with music/, models/, games/, resume/.
  2. Share it with a public link (read-only). The token is the last part of the link.
  3. Set MEDIA_ORIGIN=https://<nextcloud-host>/public.php/dav/files/<token> in Coolify.
  4. 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.

S
Description
No description provided
https://yoyos.sh
Readme
31 MiB
0 Stars 1 Watchers 0 Forks
Languages
Astro 39.3%
TypeScript 33%
CSS 12.5%
JavaScript 6.7%
Python 4.8%
Other 3.7%