Files
yoyos.sh/README.md
T
Johan Sandoval b2cd67e74f
Mirror to Gitea / mirror (push) Skipped
Initial portfolio site
Astro + React islands + MDX with a theme system (terminal, concrete,
nostromo, overgrowth), USMT Dash case study, work/log/sound/models/about/
contact pages, RSS, self-hosted contact form over SMTP, /media proxy to
Nextcloud, Dockerfile for Coolify, and a GitHub Action that mirrors main
to Gitea.
2026-10-08 14:41:39 +00:00

59 lines
3.0 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 |
| Log post | `src/content/log/<nnn-slug>.md(x)` (`draft: true` hides it in production) |
| Recording | `src/content/sound/<slug>.yaml` + audio file in the media share under `sound/` |
| 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
- `src/styles/tokens.css`: raw palette (ink, cream, emerald, rust, peat), type scale, spacing.
- `src/styles/themes/*.css`: each theme maps the palette onto semantic tokens (`--bg`, `--fg`,
`--accent`, `--signal`, `--line`, fonts, grain, scanlines). Current themes: `terminal` (default),
`concrete`, `nostromo`, `overgrowth`.
- Use a theme on a whole page: `<Base theme="concrete">`, or `theme: concrete` in a project or post's frontmatter.
- Use a theme on one section: `<section data-theme="nostromo">`.
- New theme: copy a theme file, rename the selector, import it in `themes/index.css`, and add the name to `src/lib/themes.ts`.
- One-off page styling: the page's own `<style>` block (scoped automatically), or `@layer page { }` for global overrides.
## Media share (Nextcloud)
1. In Nextcloud, make a folder (e.g. `yoyos.sh-media`) with `sound/`, `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.