b2cd67e74f0064d98181b262935bf3e8fa59aa70
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.
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.
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">, ortheme: concretein 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 tosrc/lib/themes.ts. - One-off page styling: the page's own
<style>block (scoped automatically), or@layer page { }for global overrides.
Media share (Nextcloud)
- In Nextcloud, make a folder (e.g.
yoyos.sh-media) withsound/,models/,games/,resume/. - Share it with a public link (read-only). The token is the last part of the link.
- Set
MEDIA_ORIGIN=https://<nextcloud-host>/public.php/dav/files/<token>in Coolify. - 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.
Languages
Astro
39.3%
TypeScript
33%
CSS
12.5%
JavaScript
6.7%
Python
4.8%
Other
3.7%