maurogioberti.github.io
My Personal Portfolio 🚀
Welcome to my personal website! 🌟
A hub for my portfolio, blog, talks, resume, and professional services.
⭐ Stars are welcome 😊
🐛 Report an issue
🌐 Visit my site
🚀 About This Project
This website is my personal platform to showcase my work, share blog posts, and present my professional services.
Built with Next.js 15, React 19, TypeScript, and Tailwind CSS 4, following Clean Architecture principles.
The codebase is designed to keep business logic independent from the UI layer, with clear separation between domain models, use cases, infrastructure, and presentation. Dependency Injection is used to wire services, repositories, and use cases in a predictable and maintainable way.
The goal is simple:
👉 Keep business logic independent from the UI
👉 Make everything scalable, testable, and easy to evolve
✨ Key Features
- Portfolio → Skills, experience, and key achievements
- Blog → Real insights from software engineering and consulting
- Talks → Conferences, meetups, and presentations
- Resume → Timeline + recommendations
- Services → What I can help you with
🛠 Tech Stack
- Runtime: Node.js 25.8.1 (via
.nvmrc) - Framework: Next.js 15 (App Router under
src/app) - Language: TypeScript 5
- UI: React 19 + Tailwind CSS 4 (with custom design tokens and theme support)
- Architecture: Clean Architecture (domain, application, infrastructure, crosscutting)
- Styling: Design tokens via CSS variables in
src/app/globals.css - Data Source: Local JSON files under
src/datafor posts, profile, timeline, services, and recommendations - Dependency Injection: Custom DI container (
src/di.ts) wiring services, repositories, and use cases - Testing: Jest + next/jest + Testing Library (React + jest-dom)
🚀 Getting Started
⬇️ Clone this repo
git clone https://github.com/maurogioberti/maurogioberti.github.io.git
cd maurogioberti.github.io
🟢 Set Node version (recommended)
nvm install 25.8.1
nvm use 25.8.1
📦 Install dependencies
npm install
🏁 Run in development
npm run dev
🧪 Run tests
npm test
📦 Build
npm run build
🌐 Preview production (static export)
npx serve@latest out
No environment variables required. Everything runs from JSON files in src/data.
📂 Folder Structure
This project is structured to align with Clean Architecture principles:
project-root/
├── src/
│ ├── core/
│ │ ├── domain/ # Business entities and domain models
│ │ ├── application/ # Use cases (application services)
│ │ ├── infrastructure/ # Repositories, services, data access
│ │ └── crosscutting/ # Shared concerns (DI, mapping, SEO, utils)
│ ├── app/ # Next.js App Router entrypoint
│ │ ├── layout.tsx # Root layout
│ │ ├── page.tsx # Root page
│ │ ├── globals.css # Global styles & design tokens
│ │ ├── components/ # Reusable UI components (Header, Footer, Theme, etc.)
│ │ ├── pages/ # App Router segments (home, blog, talks, resume, services)
│ │ │ ├── home/
│ │ │ ├── blog/
│ │ │ ├── talks/
│ │ │ ├── resume/
│ │ │ └── services/
│ │ └── standalone/ # Standalone pages (e.g. linktree, talktree)
│ ├── data/ # JSON data files (posts, profile, timeline, services, recommendations)
│ └── di.ts # Dependency injection configuration (wires services, repos, use cases)
└── public/ # Static assets (images, icons, open graph assets)
This structure ensures:
- Clear separation between business logic and presentation
- Testable and composable use cases and repositories
- A predictable and scalable layout for Next.js routes and static content
🧪 Testing
Testing is focused on business logic, repositories, and view models:
- Unit Tests → Jest + next/jest for TypeScript and Next.js-aware transforms
- UI Tests → Testing Library (React + jest-dom)
- Architecture-Friendly → Use cases and repositories depend on interfaces and can be easily mocked
Run the full test suite with:
npm test
📜 License
Released under MIT License by Mauro Gioberti.