Mirror to Gitea / mirror (push) Skipped
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.
59 lines
3.0 KiB
Markdown
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.
|