Mirror to Gitea / mirror (push) Skipped
- Swap every photo for Unsplash photos and Pixabay stickers/clipart, credited in IMAGE_CREDITS.md and /credits; regenerate effect images - Reveal animations never hide on-screen content and have a failsafe, so sections can no longer stay blank on phones - Tighter section and footer spacing on mobile; drop the unlabeled status dot on mobile and the blog's fake loading bar - Cover moves from the all-green poster to the board's mixed palette - New boombox, spray can and headphones stickers
89 lines
4.7 KiB
Markdown
89 lines
4.7 KiB
Markdown
# 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/` — 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.
|