59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
# lerko96 portfolio
|
|
|
|
Personal portfolio site. Live at [lerkolabs.com](https://lerkolabs.com) — self-hosted, deployed and maintained through my own operation.
|
|
|
|
Source lives on my Gitea at [gitea.lerkolabs.com](https://gitea.lerkolabs.com). GitHub is a backup mirror, not the primary.
|
|
|
|
**Stack:** Next.js 16 · React 19 · TypeScript · Tailwind v4
|
|
|
|
---
|
|
|
|
## Branches
|
|
|
|
- `dev` — source code, all work happens here
|
|
- `master` — built output only; what GitHub Pages serves for the backup mirror. don't touch this manually.
|
|
|
|
---
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
npm run dev # dev server at localhost:3000
|
|
npm run build # static export into out/
|
|
npm run deploy # build + push out/ to master (GitHub mirror)
|
|
```
|
|
|
|
---
|
|
|
|
## How it deploys
|
|
|
|
`npm run deploy` runs `predeploy` (build) then pushes the `out/` directory to `master` via `gh-pages`. That's what feeds the GitHub Pages backup at lerko96.com.
|
|
|
|
`postbuild` drops `out/.nojekyll` so GitHub Pages doesn't ignore `_next/` assets.
|
|
|
|
Custom domain is in `public/CNAME` — gets copied into `out/` on build.
|
|
|
|
---
|
|
|
|
## Project layout
|
|
|
|
```
|
|
src/
|
|
app/
|
|
layout.tsx # root layout, fonts, ThemeProvider
|
|
page.tsx # home: hero, skills, project cards
|
|
homelab/page.tsx # homelab page: VLANs, services, ADRs
|
|
archive/page.tsx # older projects grid
|
|
globals.css # full design system (Tailwind v4 CSS-first, all tokens here)
|
|
components/ # Nav, Footer, Hero, ThemeScript, etc.
|
|
context/
|
|
ThemeContext.tsx # dark mode provider + useTheme hook
|
|
data/
|
|
projects.ts # all projects, featured + archive split
|
|
services.ts # homelab services with categories
|
|
public/
|
|
CNAME # www.lerko96.com
|
|
```
|
|
|
|
> Tailwind v4 is CSS-first — no `tailwind.config.ts`. All custom tokens live in `globals.css` under `@theme {}`.
|