+```
+
+If the request fails, replace it once with `/avatar-fallback.svg`. Avoid an
+error loop and reserve dimensions to prevent layout shift.
+
+Project content remains local and curated. Optional GitHub metadata enrichment
+may happen during the GitHub Actions build, store only non-sensitive fields,
+and degrade without blocking the build. Do not expose a token or rely on a
+runtime API request.
+
+## 12. Execution roadmap
+
+### Phase 0 — governance, content, and privacy (P0) — complete
+
+- Add the adapted repository instructions and engineering conventions.
+- Convert existing/new technical documentation to English when touched.
+- Confirm the remaining content inputs in section 3.
+- Remove the residential address and personal phone number.
+- Preserve canonical career dates and calculate durations at runtime.
+- Record confirmed source content and identify evidence gaps for the deeper
+ project pass in phase 4.
+
+**Exit:** English repository governance exists, approved source content is
+structured, and unnecessary personal data is excluded.
+
+### Phase 1 — technical foundation (P0) — complete
+
+- Create Preact + TypeScript + Vite on a modernization branch.
+- Pin Node.js 24 and pnpm; add the package-manager guard.
+- Configure Biome, convention checking, Vitest, Playwright, Lefthook, and
+ Commitlint.
+- Add the Planner-style component folder/barrel convention.
+- Add typed content schemas and the typed i18next catalog.
+- Keep all work uncommitted until Lucas reviews it and explicitly requests a
+ commit.
+
+**Exit:** `pnpm check` and `pnpm build` produce a valid static site shell.
+
+### Phase 2 — design system and responsive composition (P0) — complete
+
+- Convert `docs/DESIGN.md` tokens into semantic CSS custom properties.
+- Implement the component tree from section 6.
+- Build the header, hero, timelines, cards, and footer mobile-first.
+- Apply Lora/Public Sans, the 96 px section rhythm, and 32 px editorial cards.
+- Add accessible focus, interaction, image, and error states.
+
+**Exit:** the complete English layout works from 320 to 1440 px.
+
+### Phase 3 — browser defaults, theme, and i18n (P0) — complete
+
+- Implement browser-locale detection with English fallback.
+- Implement system-theme detection with light fallback.
+- Persist explicit overrides and prevent first-paint theme flash.
+- Complete `en`, `pt-BR`, and `fr` catalogs with key parity tests.
+- Update document language and localized metadata.
+- Keep the French catalog ready for a final native or professional language
+ review before public release.
+
+**Exit:** every control and content section works in three languages and two
+themes, including missing/unsupported browser preference paths.
+
+### Phase 4 — deeper career and project evidence (P1) — complete
+
+- Publish the confirmed ABILITYA and Pluritech evidence while retaining the
+ remaining nonconfidential metric gaps for a later content update.
+- Deepen the six fixed showcase projects beyond their initial summaries.
+- Preserve the Cagliari and Role Vectors evidence cards and verify their public
+ links during release checks.
+- Build the Jig Solver feature card with its public URL, verified architecture,
+ private-source treatment, and optimized real screenshot.
+- Add Planner as a private financial-assistant project using only stack and
+ product facts verified in the local repository; expose no private link.
+- Add concise evidence-based summaries for the four public repositories.
+- Keep optional build-time GitHub metadata out of the critical rendering path.
+
+**Exit:** each project explains problem, approach, contribution, and result;
+private links and invented metrics are absent.
+
+### Phase 5 — quality, SEO, and performance (P0) — complete
+
+- Add localized Open Graph metadata, favicon, canonical URL, sitemap, and
+ `robots.txt`.
+- Prerender useful page content before JavaScript hydration.
+- Test keyboard navigation, contrast, 200 percent zoom, reduced motion, and
+ avatar fallback.
+- Run responsive Playwright checks in English, Portuguese, and French.
+- Lighthouse mobile targets: Performance at least 95 and Accessibility, Best
+ Practices, and SEO at least 95.
+
+**Exit:** `pnpm check`, production build, browser tests, and accessibility
+review pass.
+
+Completion evidence on September 11, 2026:
+
+- The production build prerenders the English fallback page before hydration
+ and passes the static-output verification script.
+- The Chromium suite passes in desktop and mobile projects, covering Axe,
+ locales and metadata, theme persistence, avatar resilience, verified public
+ links, private Planner link isolation, responsive overflow, keyboard entry,
+ reduced motion, and 200 percent text sizing.
+- Lighthouse mobile scores: Performance 98, Accessibility 100, Best Practices
+ 100, and SEO 100. Desktop scores 100 in all four categories.
+
+### Phase 6 — rename and deploy (P0) — implementation complete, activation pending
+
+- The Vite base path, canonical URL, Open Graph URL, sitemap, and `robots.txt`
+ target `https://lucaspmm.github.io/`.
+- A least-privilege GitHub Pages workflow publishes only after `CI` succeeds
+ for a trusted push to `main` or `master`.
+- GitHub Actions use stable major release tags, and the deployment rebuilds the
+ exact portfolio revision accepted by CI.
+- README and this runbook document the rename, Pages-source migration, remote
+ update, metadata update, and public smoke test.
+- Lucas still needs to rename the repository, switch Pages from the current
+ legacy branch source to GitHub Actions, merge the branch, and update external
+ profile links.
+
+**Exit:** the renamed site is live and all public links use the new URL.
+
+**Current state:** every repository-side prerequisite is implemented. The exit
+condition remains pending until the external activation checklist in section 14
+is completed and the public URL passes its smoke test.
+
+## 13. Selected repository name
+
+### `LucasPMM.github.io`
+
+This makes the repository the GitHub Pages user site and produces the clean URL
+`https://lucaspmm.github.io/`. It also allows Vite `base: '/'`. The technical
+repository name does not change the public title “Lucas Mariz.”
+
+The name is available as of September 11, 2026. The existing `Curriculum`
+repository is public, uses `master` as its default branch, and currently serves
+Pages from the repository root in legacy branch mode.
+
+## 14. Safe rename tutorial
+
+The current remote is `git@github.com:LucasPMM/Curriculum.git`, and the current
+local default branch is `master`.
+
+### A. Prepare
+
+1. Review and explicitly authorize the phase 6 implementation commit.
+2. Ensure the new build is versioned and no local work is forgotten.
+3. Record the old URL `https://lucaspmm.github.io/Curriculum/`. GitHub does not
+ automatically redirect project-site URLs when a repository is renamed.
+4. If preserving the old URL is critical, configure a custom domain before the
+ rename. Otherwise, plan to update every public link.
+
+### B. Rename on GitHub
+
+1. Open `LucasPMM/Curriculum`.
+2. Go to **Settings → General**.
+3. Set **Repository name** to `LucasPMM.github.io`.
+4. Confirm **Rename**.
+
+GitHub redirects repository web traffic and Git operations, but the Pages URL
+is the important exception.
+
+### C. Update the local clone
+
+For the selected name:
+
+```bash
+git remote set-url origin git@github.com:LucasPMM/LucasPMM.github.io.git
+git remote -v
+```
+
+The deployment workflow supports the current `master` branch as well as `main`.
+Optionally standardize the primary branch later:
+
+```bash
+git branch -m master main
+git push -u origin main
+```
+
+After the push, change the default branch to `main` under **Settings →
+Branches**. Treat this as an independent migration and remove the old remote
+branch only after `main`, CI, and Pages are verified.
+
+### D. Configure Pages
+
+1. Under **Settings → Pages → Build and deployment**, change **Source** from
+ the current legacy branch configuration to **GitHub Actions**.
+2. Merge `feat/portfolio-modernization` into the default branch. The `CI`
+ workflow will validate the merge, and its successful push run will trigger
+ `.github/workflows/deploy.yml`.
+3. Confirm that the deployment environment is named `github-pages` and that
+ its branch protection permits only the default branch.
+4. In the repository **About** settings, use:
+ - description:
+ `Senior software engineer portfolio, selected work, and applied research.`
+ - website: `https://lucaspmm.github.io/`
+ - topics: `portfolio`, `preact`, `typescript`, `vite`, `github-pages`.
+5. Set the GitHub profile Website and the relevant LinkedIn link to
+ `https://lucaspmm.github.io/`.
+
+### E. Verify
+
+1. Confirm the `CI` and `Deploy to GitHub Pages` workflows are green.
+2. Open the public URL in a private browser window.
+3. Verify direct loading, assets, anchor navigation, avatar fallback, external
+ links, locale, theme, and mobile layout.
+4. Update LinkedIn and any other source still pointing to `/Curriculum/`.
+
+## 15. Definition of done
+
+- Repository governance and technical documentation are in English.
+- Source code and comments are in English; visitor copy is localized.
+- No residential address or personal phone number is shipped.
+- Career and education dates match section 3, with expected graduation in 2027.
+- ABILITYA and Pluritech descriptions are accurate and contain no invented
+ metrics.
+- The showcase order is Jig Solver, Planner, Simplex, Pokémon Base, Greedy
+ K-means, and LZ78 Compression.
+- Jig Solver links only to the public application and uses a real optimized
+ screenshot.
+- The profile image comes from GitHub and has a local fallback.
+- A first visit uses the browser locale or English fallback.
+- A first visit uses the system color scheme or light fallback.
+- Explicit locale/theme choices persist and invalid values recover safely.
+- English, Brazilian Portuguese, and French catalogs have key parity.
+- Both themes pass contrast and preserve the documented design system.
+- The site works by keyboard, at 320 px, at 200 percent zoom, and with reduced
+ motion.
+- Biome is the only web formatter/linter, and `pnpm check` passes.
+- Commit messages are English Conventional Commits, hooks are not bypassed, and
+ coding agents do not commit without explicit authorization.
+- GitHub Actions deploys only after all quality checks pass.
+- README, canonical, Open Graph, and static discovery files use the final URL.
+- After activation, the repository metadata, GitHub profile, and LinkedIn use
+ the final URL.
+
+## Technical references
+
+- [GitHub repository profile](https://github.com/LucasPMM)
+- [Lucas Mariz LinkedIn profile](https://www.linkedin.com/in/lucas-mariz-4845b6164/)
+- [Jig Solver public application](https://jigsolver.app/)
+- [Renaming a repository — GitHub Docs](https://docs.github.com/en/repositories/creating-and-managing-repositories/renaming-a-repository)
+- [Deploying a Vite site to GitHub Pages](https://vite.dev/guide/static-deploy.html#github-pages)
+- [Custom workflows for GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/using-custom-workflows-with-github-pages)
+- [Preact getting started](https://preactjs.com/guide/v10/getting-started/)
+- [Preact Vite prerendering](https://preactjs.com/blog/prerendering-preset-vite/)
+- [i18next configuration and fallback](https://www.i18next.com/overview/configuration-options)
diff --git a/e2e/portfolio.spec.ts b/e2e/portfolio.spec.ts
new file mode 100644
index 0000000..d54a1ef
--- /dev/null
+++ b/e2e/portfolio.spec.ts
@@ -0,0 +1,164 @@
+import AxeBuilder from '@axe-core/playwright'
+import { expect, test } from '@playwright/test'
+
+const localeCases = [
+ {
+ locale: 'en',
+ languageLabel: 'Language',
+ experienceHeading: 'Professional experience',
+ pageTitle: 'Lucas Mariz — Senior Software Engineer',
+ openGraphLocale: 'en_US',
+ },
+ {
+ locale: 'pt-BR',
+ languageLabel: 'Language',
+ experienceHeading: 'Experiência profissional',
+ pageTitle: 'Lucas Mariz — Engenheiro de Software Sênior',
+ openGraphLocale: 'pt_BR',
+ },
+ {
+ locale: 'fr',
+ languageLabel: 'Language',
+ experienceHeading: 'Expérience professionnelle',
+ pageTitle: 'Lucas Mariz — Ingénieur logiciel senior',
+ openGraphLocale: 'fr_FR',
+ },
+] as const
+
+test.beforeEach(async ({ page }) => {
+ await page.addInitScript(() => {
+ const resetMarker = 'portfolio.test-storage-reset'
+ if (window.sessionStorage.getItem(resetMarker)) return
+ window.localStorage.clear()
+ window.sessionStorage.setItem(resetMarker, 'true')
+ })
+})
+
+test('renders without automated accessibility violations', async ({ page }) => {
+ await page.goto('/')
+ const results = await new AxeBuilder({ page }).analyze()
+ expect(results.violations).toEqual([])
+})
+
+test('uses browser language and color-scheme defaults on the first visit', async ({ browser }) => {
+ const context = await browser.newContext({ locale: 'pt-BR', colorScheme: 'dark' })
+ const page = await context.newPage()
+ await page.goto('/')
+ await expect(page.locator('html')).toHaveAttribute('lang', 'pt-BR')
+ await expect(page.locator('html')).toHaveAttribute('data-theme', 'dark')
+ await expect(page.getByRole('heading', { name: 'Experiência profissional' })).toBeVisible()
+ await context.close()
+})
+
+localeCases.forEach(({ locale, languageLabel, experienceHeading, pageTitle, openGraphLocale }) => {
+ test(`synchronizes content and metadata for ${locale}`, async ({ page }) => {
+ await page.goto('/')
+ await page.getByLabel(languageLabel).selectOption(locale)
+ await expect(page.getByRole('heading', { name: experienceHeading })).toBeVisible()
+ await expect(page.locator('html')).toHaveAttribute('lang', locale)
+ await expect(page).toHaveTitle(pageTitle)
+ await expect(page.locator('meta[property="og:locale"]')).toHaveAttribute(
+ 'content',
+ openGraphLocale,
+ )
+ })
+})
+
+test('persists an explicit dark theme', async ({ page }) => {
+ await page.goto('/')
+ await page.getByLabel('Theme').selectOption('dark')
+ await expect(page.locator('html')).toHaveAttribute('data-theme', 'dark')
+ await page.reload()
+ await expect(page.locator('html')).toHaveAttribute('data-theme', 'dark')
+})
+
+test('falls back to the local avatar when GitHub is unavailable', async ({ page }) => {
+ await page.route('**/LucasPMM.png**', (route) =>
+ route.fulfill({ status: 503, contentType: 'text/plain', body: 'Unavailable' }),
+ )
+ await page.goto('/')
+ await expect(page.getByRole('img', { name: 'Lucas Mariz' })).toHaveAttribute(
+ 'src',
+ /avatar-fallback\.svg$/,
+ )
+})
+
+test('loads the primary project evidence and exposes only public project links', async ({
+ page,
+}) => {
+ await page.goto('/')
+ const projectImage = page.locator('#projects .product-frame img')
+ await projectImage.scrollIntoViewIfNeeded()
+ await expect
+ .poll(() =>
+ projectImage.evaluate((image) => image instanceof HTMLImageElement && image.naturalWidth > 0),
+ )
+ .toBe(true)
+
+ await expect(page.getByRole('link', { name: 'Open jigsolver.app' })).toHaveAttribute(
+ 'href',
+ 'https://jigsolver.app/',
+ )
+ const plannerCard = page
+ .locator('article')
+ .filter({ has: page.getByRole('heading', { name: 'Planner', exact: true }) })
+ await expect(plannerCard.getByRole('link')).toHaveCount(0)
+
+ const publicRepositories = [
+ 'https://github.com/LucasPMM/simplex',
+ 'https://github.com/LucasPMM/Pokemon-Base',
+ 'https://github.com/LucasPMM/greedy-kmeans',
+ 'https://github.com/LucasPMM/lz78-compression',
+ ]
+ for (const repository of publicRepositories) {
+ await expect(page.locator(`a[href="${repository}"]`)).toHaveAttribute('target', '_blank')
+ }
+})
+
+test('keeps the page free of horizontal overflow at representative widths', async ({ page }) => {
+ const widths = [320, 768, 1440]
+ await page.goto('/')
+ for (const width of widths) {
+ await page.setViewportSize({ width, height: 900 })
+ const hasOverflow = await page.evaluate(
+ () => document.documentElement.scrollWidth > document.documentElement.clientWidth,
+ )
+ expect(hasOverflow).toBe(false)
+ }
+})
+
+test('supports keyboard entry and reduced motion', async ({ page }) => {
+ await page.emulateMedia({ reducedMotion: 'reduce' })
+ await page.goto('/')
+ await page.keyboard.press('Tab')
+ await expect(page.getByRole('link', { name: 'Skip to content' })).toBeFocused()
+ await page.keyboard.press('Enter')
+ await expect(page.locator('#main-content')).toBeInViewport()
+ await expect(page.locator('html')).toHaveCSS('scroll-behavior', 'auto')
+})
+
+test('remains usable with text enlarged to 200 percent', async ({ page }) => {
+ await page.setViewportSize({ width: 640, height: 900 })
+ await page.goto('/')
+ await page.evaluate(() => {
+ document.documentElement.style.fontSize = '200%'
+ })
+ const overflowingElements = await page.locator('body *').evaluateAll((elements) =>
+ elements
+ .filter((element) => {
+ const bounds = element.getBoundingClientRect()
+ return bounds.right > document.documentElement.clientWidth || bounds.left < 0
+ })
+ .map((element) => ({
+ bounds: {
+ left: Math.round(element.getBoundingClientRect().left),
+ right: Math.round(element.getBoundingClientRect().right),
+ },
+ className: element.getAttribute('class') ?? '',
+ tagName: element.tagName,
+ text: element.textContent?.trim().slice(0, 40),
+ })),
+ )
+ expect(overflowingElements).toEqual([])
+ await expect(page.getByRole('heading', { level: 1 })).toBeVisible()
+})
diff --git a/index.html b/index.html
index 743bfb1..75deb2c 100644
--- a/index.html
+++ b/index.html
@@ -1,117 +1,51 @@
-
-
-
-
-
-
-
- 
-
-
-
-
-
-
-
- SOBRE
-Técnico em informática e em desenvolvimento de sistemas formado pelo Colégio Técnico da UFMG e estudante de Ciência da Computação na UFMG. Personalidade forte, interessado em novas tecnologias, aplicado em projetos envolvendo as mais diversas linguagens de programação e músico nos tempos livres.
-
-
- CONTATO
-Rua Radialista César Dos Santos - 151 - Belo Horizonte/Brasil
-(31)97502-7868
-lucaspaulomm@gmail.com
- -Lucas Mariz
-
-
- HABILIDADES
-
-
-
-
- HTLM
-CSS
-JS
-C
-
-
- PYTHON
-REACT
-PHP
-Git
-
-
- LÍNGUAS
-Portugês -
-
-
-
- Inglês -
-
-
-
- 
+