Files
webgpu-portfolio/README.md
djoser 08e67c8a6a
Some checks failed
CI / test-and-build (push) Failing after 9s
Build & Deploy / build (push) Successful in 16s
Build & Deploy / deploy (push) Failing after 39s
docs: note post-redeploy verification
2026-08-21 02:51:50 +00:00

48 lines
1.3 KiB
Markdown

# Djosen — personal site
Hugo static site (hugo-coder theme, dark) with a WebGPU spiral background on the homepage.
[![Build & Deploy](https://git.djosen.one/djoser/webgpu-portfolio/actions/workflows/deploy.yml/badge.svg?branch=master)](https://git.djosen.one/djoser/webgpu-portfolio/actions)
## Structure
- **Hugo site (repo root):** `content/` (pages, projects, posts), `data/resume.yaml`, `layouts/` (custom homepage/resume templates), `themes/hugo-coder` (git submodule), `static/gpu/` (the compiled engine bundle).
- **`gpu-bg/`** — the WebGPU/WebGL2 background engine (`Vite` + `Typescript`), built to a static JS bundle.
- **`archive/`** — the retired Vite SPA, preserved for reference.
## Dev
**Hugo server** (site content):
```bash
hugo server
```
**Engine** (background):
```bash
cd gpu-bg && npm run dev
```
**Full loop** — build the engine, copy the bundle into the Hugo site, then serve:
```bash
cd gpu-bg && npm install && npm run build
cp gpu-bg/dist/engine.js static/gpu/engine.js
hugo server
```
## Docker
```bash
docker compose build
docker compose up -d
```
Site at `http://127.0.0.1:8080`.
## Deploy
Server-side deployment (Gitea Actions / webhook) is documented in [DEPLOYMENT.md](DEPLOYMENT.md) — including the mandatory recursive-submodule checkout for the Hugo build.
<small>deploy verified 2026-08-21</small>