# 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`. ```bash 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/.md(x)` or `src/content/work//index.mdx` with images next to it | | Blog post | `src/content/blog/.md(x)` (`draft: true` hides it in production) | | Recording | `src/content/music/.yaml` + audio file in the media share under `music/` | | 3D model | `src/content/models/.yaml` + `.glb` in the media share under `models/` | | Game | add a `game:` block to a project + web export in the media share under `games//` → playable at `/play/` | | 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: ``, 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/` — all CC0 / public domain via Openverse, listed in `src/data/photo-credits.json` and shown at `/credits`. Add new ones there too. ### 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:///public.php/dav/files/` in Coolify. 4. Files are then served from `https://yoyos.sh/media/`, 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.