Files
yoyos.sh/README.md
T
Johan Sandoval 61f55e2568
Mirror to Gitea / mirror (push) Skipped
Mixed-media redesign, Chicago transit system and motion
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.
2026-10-08 16:28:16 +00:00

89 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/<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/` — 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://<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.