feat: add randomized portfolio hero variants

README.md

@@ -1,36 +1,88 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+<div align="center">
 
-## Getting Started
+# Evandro Dev — Portfolio
 
-First, run the development server:
+**A cinematic, interactive developer portfolio built with Next.js, React, TypeScript, and motion-first UI engineering.**
 
-```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
+![Next.js](https://img.shields.io/badge/Next.js-15-000?logo=nextdotjs)
+![React](https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=111)
+![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript&logoColor=fff)
+![Biome](https://img.shields.io/badge/Code%20Style-Biome-60A5FA)
+![Jest](https://img.shields.io/badge/Tests-Jest-C21325?logo=jest&logoColor=fff)
+
+</div>
+
+## Overview
+
+This is the portfolio site for **Evandro Dev**. It presents professional work, case studies, technical positioning, and interactive visual storytelling through a high-polish Next.js interface.
+
+The project combines a modern App Router codebase with motion design, 3D/visual effects, and tested UI components.
+
+## Highlights
+
+| Area | Details |
+| --- | --- |
+| Framework | Next.js App Router with React and TypeScript. |
+| Motion | GSAP, Framer Motion, Lenis, and custom animation components. |
+| Visuals | Three.js / React Three Fiber / Drei for interactive and cinematic surfaces. |
+| Styling | Tailwind CSS, utility composition, and reusable component primitives. |
+| Quality | Jest, Testing Library, property-based tests, and Biome checks. |
+| Content | Portfolio sections, case pages, company logos, hero composition, and supporting docs. |
+
+## Project structure
+
+```txt
+app/
+  page.tsx           Main portfolio route
+  layout.tsx         Root layout and metadata
+  components/        Portfolio sections and cinematic UI modules
+  cases/             Case-study routes/content
+  api/               Server/API routes
+components/          Shared UI primitives
+lib/                 Utilities and shared logic
+docs/                Supporting documentation
+graphify-out/        Project analysis output
+public/              Static assets
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+## Getting started
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+```bash
+pnpm install
+pnpm dev
+```
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+The development server uses Turbopack through the project script.
 
-## Learn More
+## Scripts
 
-To learn more about Next.js, take a look at the following resources:
+| Command | Purpose |
+| --- | --- |
+| `pnpm dev` | Start the Next.js development server. |
+| `pnpm build` | Build the production application. |
+| `pnpm start` | Start the production server after building. |
+| `pnpm lint` | Run Biome checks. |
+| `pnpm format` | Format the codebase with Biome. |
+| `pnpm test` | Run Jest tests. |
+| `pnpm test:watch` | Run Jest in watch mode. |
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+## Engineering standards
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+- Keep visual sections modular and testable.
+- Respect reduced-motion and accessibility expectations for animated sections.
+- Keep portfolio copy and case-study content easy to update without touching low-level animation code.
+- Validate interactive components with tests when changing behavior, layout assumptions, or accessibility states.
 
-## Deploy on Vercel
+## Validation
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+Before publishing changes:
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+```bash
+pnpm lint
+pnpm test
+pnpm build
+```
+
+## License
+
+Personal portfolio project unless a repository license says otherwise.