Back to Works

Portfolio v2

A comprehensive digital portfolio and engineering journal documenting the evolution of a Fullstack Developer. This project serves as a high-performance sandbox for advanced web technologies.

Next.js 16
Feature-Sliced Design
React 19
Dockerized

Concept & Vision

A fusion of creative design and strict engineering principles, built to demonstrate the capabilities of the modern React ecosystem.

This portfolio serves as both a showcase of technical mastery and a living documentation of architectural decisions, patterns, and best practices in modern web development.

Key Principles

  • High-performance sandbox for advanced web technologies
  • Strict architectural boundaries and patterns
  • Engineering journal and learning documentation

Frontend Architecture

Built on Next.js 16 and follows Feature-Sliced Design (FSD) principles to ensure scalability and maintainability.


src/
├── app/                    # Routing, Layouts, Global Providers ONLY
├── entities/               # Business domain models (User, Product)
├── features/               # User interactions (Auth, Checkout)
├── shared/                 # Reusable generics (UI Kit, Libs, Config)
└── widgets/                # Composition of features/entities
          

Strict Public API

Every module exposes functionality ONLY via index.ts. No direct internal imports allowed.

Data Access Layer

Centralized DAL with DTO mapping and React 19 cache directives for security and performance.

Technical Stack

Framework
Next.js 16
Core
React 19
Language
TypeScript
Styling
Tailwind CSS 4
Architecture
FSD
Validation
Zod

Backend Integration

Parallel backend development provides all data through a centralized API. The frontend communicates exclusively through the Data Access Layer with strict security patterns.

Data Flow Architecture

Frontend ComponentsServer Actions
Server ActionsData Access Layer
DALBackend API
Backend APIDatabase/External Services

Documentation & Standards

Strict conventional commit format and comprehensive architectural documentation ensure maintainability and team collaboration.

Commit Standards

feat, wip, fix, docs, style, refactor, test, chore

Clean, readable history with semantic versioning support

Architecture Rules

Detailed patterns, data flow, coding standards

Comprehensive context for AI agents and contributors

Deployment & Infrastructure

The application is fully containerized for consistent environments across development and production.

Quick Start

# Build and run in background
docker-compose up -d --build

# View application
# http://localhost:3000