Personal website and a playground

Personal website and playground by (and for - aka me) a full-stack engineer increasingly focused on self-hosted solutions, privacy, and security.

Coverage badges are self-managed. Regenerate from tests with:

• just badges-update

Stack

• Frontend: SvelteKit + TypeScript + Bun
• Backend: Go + gRPC
• Data store: Valkey (Redis-compatible)
• Tooling: Just, Buf, Protobuf, Biome, Vitest, Playwright, Nix Flakes

Repository layout

.
├── frontend/      # SvelteKit app (UI, tests, styles)
├── backend/       # Go gRPC server
├── proto/         # .proto contracts
├── deployment/    # Kubernetes/K3s manifests
├── docs/          # planning/notes
└── justfile       # main task runner

Prerequisites

Recommended local tools:

• just
• bun
• go
• protoc
• buf
• valkey

If you use Nix, everything is provided by the project dev shell:

nix develop

Quick start (local)

From repo root:

# Install codegen tools + backend/frontend deps
just install

# Generate protobuf stubs (Go + TypeScript)
just generate

Start Valkey (if you do not already have one running):

docker run --rm -p 6379:6379 valkey/valkey:latest

Run backend and frontend in separate terminals:

just backend-run
just frontend-dev

Default local endpoints:

• Frontend: http://localhost:5173
• Backend (gRPC): localhost:8080
• Valkey: localhost:6379

Environment variables

Variable	Default	Used by	Description
VALKEY_ADDR	localhost:6379	backend	Valkey server address

Common commands

Frontend

just frontend-deps
just frontend-dev
just frontend-build
just frontend-check
just frontend-lint
just frontend-format
just frontend-format-check
just frontend-test
just frontend-test-e2e

Backend

just backend-deps
just backend-run
just backend-build
just backend-test
just backend-test-cover

Protobuf

just generate
just generate-go
just generate-ts

Combined

<<<<<<< HEAD
just test       # backend + frontend unit
just test-all   # backend + frontend unit + frontend e2e
=======
just test           # backend + frontend unit
just test-all       # backend + frontend unit + frontend e2e
just badges-update  # regenerate local coverage badge SVGs
>>>>>>> f0925d9e32dfac0273119a8a76798df3f5045b6a

Current status

• Frontend portfolio site is active and evolving.
• gRPC contract is defined in proto/blog.proto.
• Backend blog service methods are scaffolded and ready for implementation.

Deployment

Kubernetes/K3s manifests and instructions live in:

• deployment/README.md ... eventually. Right now it's just deployed via Dokploy -- webhook in prod build ci

License

No license file has been added yet.