Files
yoyos.sh/README.md
T
Johan Sandoval ef9d597b52
Mirror to Gitea / mirror (push) Skipped
Redesign with per-page themes and plain wording
Each page now has its own look drawn from print and retro-tech references:
magazine-cover home, subway-map work index, technical-poster project pages,
90s-desktop blog, radio-flyer music page, 80s wireframe 3D page, garden
about page and postcard contact form. A shared subway-line color system
ties sections and project categories together.

Replace themed copy with standard wording (Work, Blog, Music, 3D, About,
Contact; Selected work, Experience, Get in touch). Rename /log to /blog and
/sound to /music with redirects.
2026-10-08 15:36:51 +00:00

74 lines
3.8 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, built on one shared palette and a "subway line" color system
(every section and project category has a line color + badge, see `src/lib/disciplines.ts`).
| Theme | Used on | Feel |
|---|---|---|
| `magazine` (default) | Home | 90s magazine cover / print ad |
| `transit` | Work index | Subway map, transit cards |
| `spec` | Project pages | Technical exhibition poster |
| `desktop` | Blog, 404 | Late-90s desktop windows |
| `radio` | Music | College-radio flyer, dot-matrix type |
| `vector` | 3D models | 80s computer graphics, wireframes |
| `garden` | About | Grass, cream blobs, lowercase type |
| `postcard` | Contact | Postcard + stamp |
| `terminal` | (available) | Green-phosphor CRT |
- `src/styles/tokens.css`: raw palette (paper, ink, lime, red, cobalt, yellow, emerald...), font stacks, type scale, spacing.
- `src/styles/themes/*.css`: each theme maps the palette onto semantic tokens (`--bg`, `--fg`, `--accent`,
`--font-display`, heading weight/case/width, border, shadow, grain, scanlines).
- Use a theme on a page: `<Base theme="radio">`, or `theme: vector` in a project/post's frontmatter
(projects default to `spec`, posts to `desktop`). Use it on one section: `<section data-theme="garden">`.
- New theme: copy a theme file, rename the selector, import it in `themes/index.css`, add the name to `src/lib/themes.ts`.
- Page-specific flourishes live in each page's own `<style>` block (scoped automatically).
- Decorative components: `src/components/deco/` (Starburst, Barcode, Window, Stamp) and `LineBadge`.
## 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.