Personal portfolio of a mid-level fullstack developer, styled with a Terminal / CLI aesthetic. Single page: hero (with portrait) → GitHub repos → experience timeline → skills → contact, with English/Portuguese (pt-BR) internationalization.
Design principles and trade-offs of the chosen style live in STYLE.md.
- React 19 + Vite + TypeScript (React Compiler enabled)
- Tailwind CSS v4 (
@tailwindcss/vite, CSS-first config insrc/index.css) - react-i18next (en default, pt-BR; localStorage-persisted choice)
- bun as package manager / script runner
- oxlint for linting
| Command | What it does |
|---|---|
bun install |
Install dependencies |
bun run dev |
Start dev server |
bun run build |
Type-check (tsc -b) + production build (runs fetch-repos first) |
bun run fetch-repos |
Fetch GitHub repos into src/data/repos.json |
bun run lint |
Lint with oxlint |
bun run preview |
Preview the production build |
- Structured content (profile, timeline, skill groups) —
src/data/content.en.ts/content.pt.ts(typed viaPortfolioContent;getContent()picks the active locale). Replace the placeholder content with your real info in both files. - UI strings —
src/i18n/en.json/pt.json(keys type-checked againsten.json). - Contact links —
src/data/contact.ts(language-agnostic). - Portrait —
src/assets/face.jpg. - Adding a language: create
src/i18n/<lang>.json(mirroringen.json) +content.<lang>.ts, register it insrc/i18n/index.ts(resources,locales) and ingetContent()'s map.
scripts/fetch-repos.ts runs at build time (prebuild) and writes src/data/repos.json:
$env:GITHUB_USERNAME = "yourusername" # required to fetch
$env:GITHUB_TOKEN = "ghp_..." # optional, raises rate limits
bun run fetch-reposIf GITHUB_USERNAME is unset or the fetch fails, the existing repos.json is kept
(or a placeholder is written) and the build continues.
scripts/fetch-repos.ts # build-time GitHub fetch
src/
assets/face.jpg # hero portrait
components/ # Nav, Hero, Repos, Timeline, Skills, Contact, Footer,
# LanguageSwitcher, Terminal (shared styled primitives)
data/ # content.{ts,en.ts,pt.ts}, contact.ts, repos.{ts,json}, types.ts
i18n/ # i18next setup + en.json/pt.json + type augmentation
docs/superpowers/specs/ # design spec (incl. style decision log)