Software engineer focused on AI solutions, cloud and data. A neural-network themed single page where scrolling is a forward pass.
- Concept
- Highlights
- Tech stack
- Getting started
- Scripts
- Deployment
- Project structure
- The SplashCursor rule
- Performance & accessibility
- Editing content
- Workflow & conventions
- Credits
- License
The page is a network you run by scrolling:
| Layer | Section | What happens |
|---|---|---|
layer_01 — input |
Hero | Portrait with a glowing rim, decrypting name, rotating role, "dendrite" threads. Fluid SplashCursor on. |
| ↓ forward pass | Transition | A sticky SVG network draws itself layer by layer while an epoch / loss read-out converges. |
layer_02 — hidden |
Projects | Bento cards with edge glow, procedural covers and decrypting titles. The pointer "activates neurons" instead: splash off. |
| ↓ activation | Transition | Two crossing velocity-reactive marquees, then the next section fires open from a circle. |
layer_03 — output |
Manifesto | Long-form text that brightens word by word with the scroll, contact CTA. Splash on again. |
![]() |
![]() |
![]() |
![]() |
- Dark-first, bilingual. Two toggles in the header: language (English by default, Spanish; shareable with
?lang=es) and theme (dark by default) with a circular View Transition reveal from the button. - Black & white, electric blue details. Bright blue on black, deep blue on white — every accent meets WCAG AA.
- Portrait that adapts to the theme. Background-free photo with pre-baked halo and rim masks: white glow in dark mode, blue in light mode, fading into the page.
- Component libraries, tuned. React Bits and Skiper UI components installed through the shadcn registry and adapted for performance and accessibility (see docs/COMPONENTS.md).
- Mobile-first behaviour. Touch devices get the lightweight version of every effect, hover effects play when a card is centred on screen, and nothing overflows from 320 px to 4K.
- Fully static. No backend and no runtime server work: any static host or CDN can serve it.
| Area | Choice |
|---|---|
| Framework | Next.js 16 (App Router, statically prerendered) · React 19 |
| Language | TypeScript (strict) |
| Styling | Tailwind CSS v4 · CSS custom properties for design tokens |
| Motion | motion (LazyMotion + m) · CSS-variable–driven scroll effects |
| WebGL / 2D | Fluid simulation (SplashCursor) · ogl · Canvas 2D · GSAP (DotGrid only) |
| Components | React Bits · Skiper UI (vendored via the shadcn CLI) |
| Images | sharp build-time pipeline (AVIF/WebP, pre-baked glow masks) |
| Testing | Vitest + Testing Library · Playwright + axe |
| Tooling | pnpm · ESLint · Prettier · husky · lint-staged · commitlint |
| CI/CD | GitHub Actions · Lighthouse CI · CodeQL · release-please · Dependabot |
Requirements: Node.js ≥ 20.9 (see .nvmrc) and pnpm (the version is pinned in package.json).
pnpm install # also installs the git hooks
pnpm dev # http://localhost:3000pnpm dev and pnpm build first run the image pipeline (scripts/optimize-images.mjs), which generates the responsive portrait and its glow masks into public/images/generated/ (git-ignored, cached between runs).
Optional environment variable:
| Variable | Purpose | Default |
|---|---|---|
NEXT_PUBLIC_SITE_URL |
Canonical origin used by metadata, the Open Graph image, the sitemap and robots.txt | https://molinadev.co |
| Command | Description |
|---|---|
pnpm dev |
Image pipeline + development server |
pnpm build |
Image pipeline + production build |
pnpm start |
Serve the production build |
pnpm images |
Regenerate the portrait assets (--force to ignore the cache) |
pnpm lint |
ESLint |
pnpm typecheck |
Route type generation + tsc --noEmit |
pnpm format |
Prettier (write) · pnpm format:check to verify |
pnpm test |
Unit tests (Vitest) |
pnpm test:e2e |
End-to-end tests (Playwright) against the production build — run pnpm build first. Locally you can reuse an installed browser with PW_CHANNEL=chrome. |
Production runs on Vercel at molinadev.co. The site is fully static, so no server configuration is needed.
-
Import the repository in Vercel with the project root (
./) as Root Directory. Vercel detects Next.js and pnpm. -
Keep the default build settings. Vercel runs the
buildscript frompackage.json, which generates the portrait assets and then runsnext build. Do not override the build command with plainnext build: the image pipeline would be skipped. -
Environment variables (Settings → Environment Variables):
Variable Value Environments NEXT_PUBLIC_SITE_URLhttps://molinadev.coProduction ENABLE_EXPERIMENTAL_COREPACK1All Corepack makes Vercel install the exact pnpm version pinned in
package.json(packageManager). Preview deployments keephttps://molinadev.coas their canonical URL (the default insrc/content/social.ts), so search engines only index production. -
Node.js 22.x in Settings → General (matches
.nvmrc). -
Domain (Settings → Domains): add
molinadev.coandwww.molinadev.co, redirectwwwto the apex, and create the DNS records Vercel shows (anArecord for the apex and aCNAMEforwww) at the domain registrar. HTTPS certificates are issued automatically.
main deploys to production; every pull request gets its own preview URL.
.
├── assets/source/ # original photos (not served)
├── docs/ # architecture, design system, components, performance, content, ADRs
├── public/ # static files (generated images land in public/images/generated)
├── scripts/ # build-time scripts (image pipeline)
├── src/
│ ├── app/ # layout, page, metadata routes (OG image, sitemap, robots, icon), globals.css
│ ├── components/
│ │ ├── cursor/ # SplashCursor (WebGL), zone store and controller
│ │ ├── layout/ # header, theme & language toggles
│ │ ├── sections/ # hero, projects, manifesto (+ footer)
│ │ ├── transitions/ # forward pass, activation bands
│ │ ├── projects/ # project card and procedural covers
│ │ ├── text/ # rich-text markup, blur and scroll reveals
│ │ ├── reactbits/ # vendored React Bits components
│ │ └── skiper/ # adapted Skiper UI components
│ ├── content/ # projects, social links, portrait metadata
│ ├── hooks/ # reduced motion, theme, in-view helpers
│ ├── i18n/ # typed EN/ES dictionaries and provider
│ └── lib/ # constants, device tiers, utilities
└── tests/ # unit (Vitest) and e2e (Playwright)
More detail in docs/ARCHITECTURE.md.
The fluid cursor is active on the hero and the manifesto and disabled over the projects. It is a hard requirement, so it is implemented and tested explicitly:
- Sections declare
data-splash="on" | "off". A single, persistent WebGL instance only injects fluid while the pointer is over anonzone. - The fixed canvas is clipped to the visible
onsection, so fluid never paints over the projects. - The render loop sleeps ~2.5 s after the last input: zero GPU while reading or over the projects.
- The simulation is mounted on the first pointer/touch interaction, runs at low resolution on phones and tablets, and is skipped entirely for
prefers-reduced-motion. html[data-splash-state]mirrors the state andtests/e2e/splash-cursor.spec.tsasserts it.
Lighthouse on the production build (local run, simulated throttling):
| Profile | Performance | Accessibility | Best practices | SEO |
|---|---|---|---|---|
| Desktop | 99 | 100 | 100 | 100 |
| Mobile (slow 4G, 4× CPU) | 71–78 | 100 | 100 | 100 |
Budgets are enforced in CI (lighthouserc.mobile.json, lighthouserc.desktop.json). What makes it fast — lazy WebGL, CSS-variable–driven scroll effects, Suspense-split hydration, pre-baked image effects — is explained in docs/PERFORMANCE.md.
Accessibility: semantic landmarks and headings, skip link, keyboard-operable toggles (role="switch"), every animated text has a plain screen-reader copy, AA contrast in both themes and full prefers-reduced-motion support. axe runs in the e2e suite for both themes.
- Copy (both languages):
src/i18n/dictionaries/— typed against one interface, so a missing translation fails the build. - Projects:
src/content/projects.ts— screenshots live inpublic/images/projects/. - Links:
src/content/social.ts. - Portrait: replace
assets/source/portrait-transparent.pngand runpnpm images --force.
Step-by-step guide: docs/CONTENT.md.
- Branch from
main, open a pull request; CI (lint, types, format, unit, build, e2e), Lighthouse and CodeQL must pass. - Commits and PR titles follow Conventional Commits in English (
feat,fix,perf,docs,test,build,ci,chore,refactor,style,revert), enforced by commitlint and a PR-title check. - release-please turns merged commits into versioned releases and the CHANGELOG.
- Decisions are recorded as ADRs in docs/adr.
- React Bits by David Haz — SplashCursor, DecryptedText, RotatingText, StarBorder, Magnet, WebThreads, BorderGlow, DotGrid, ScrollVelocity, ShinyText, Particles, ClickSpark (MIT + Commons Clause).
- Skiper UI by Gurvinder Singh — theme toggle (skiper26), progressive blur (skiper41), text roll (skiper58), animated link (skiper40), scroll-assembled heading (skiper31). Free components used with the required attribution.
- SplashCursor is based on Pavel Dobryakov's WebGL Fluid Simulation.
- Fonts: Geist and Instrument Serif.
The source code is released under the MIT License. The personal content — photos, texts and project descriptions — is © Cristian Molina, all rights reserved, and may not be reused without permission. Third-party components keep their own licenses (see Credits).



