PortfolioWebsite README

README проекта с github.com/AhmadHassan-BTed/PortfolioWebsite. Одним файлом markdown: README.md.

B-Ted Logo

Ahmad Hassan | B-Ted Portfolio

Designing with Pixels, Coding with Precision

Vite Status Stack


A sophisticated, high-performance portfolio repository engineered by Ahmad Hassan (B-Ted). This project bridges the gap between complex software engineering and high-fidelity UI/UX design.

Live Demo • Contact Me • My Story


Architecture Overview

The repository is structured with a focus on strict modularity and high cohesion. By separating the build-time logic from the runtime assets, the system ensures near-instantaneous load times and maintainable code boundaries.

System Design

graph TD
    User([User Browser]) --> Build[Vite Pipeline]
    Build --> UI[Static Assets / HTML]
    UI --> Styles[src/styles]
    UI --> Logic[src/scripts]
    Logic --> Assets[public/assets]
    
    subgraph "Internal Core"
        Styles --> CSS[Global & Component CSS]
        Logic --> JS[Modular ES6 Logic]
    end
    
    subgraph "Asset Management"
        Assets --> Images[Optimized Imagery]
        Assets --> PDF[Digital Assets]
    end

System Workflow

The project utilizes a modern development lifecycle, transitioning from raw source files to an optimized production container.

sequenceDiagram
    participant Dev as Local Developer
    participant Vite as Vite Dev Server
    participant Build as Build Pipeline
    participant Docker as Production Container
    
    Dev->>Vite: npm run dev
    Vite-->>Dev: Hot Module Replacement (HMR)
    Dev->>Build: npm run build
    Build->>Build: Minification & Tree-shaking
    Build->>Docker: Package static files
    Docker-->>User: Serve via Nginx

Repository Structure

A carefully organized hierarchy designed for scalability and clear separation of concerns.

.
├── src/
│   ├── scripts/          # Modularized JavaScript logic
│   ├── styles/           # Component-specific and Global CSS
│   └── config/           # Environment-based configuration
├── public/
│   └── assets/           # High-resolution media and artifacts
│       └── hd/           # Raw high-fidelity source assets
├── Dockerfile            # Containerization strategy
├── package.json          # Project orchestration & dependencies
├── vite.config.js        # Build-time optimization configuration
└── index.html            # Main entry point

Technical Features

High-Fidelity UI/UX Polished aesthetics with fluid transitions and pixel-perfect layouts, meticulously crafted to reflect Ahmad's design philosophy.
Optimized Build Pipeline Leveraging Vite for tree-shaking, automated bundling, and high-performance asset serving.
Containerization Full Docker support for consistent deployment across any environment, served through a lightweight Nginx image.

Development Workflow

The project is maintained with a focus on ease of onboarding and technical trustworthiness.

Prerequisites

Local Setup

Command Description
npm install Synchronize all project dependencies.
npm run dev Initialize the reactive development server.
npm run build Generate the optimized production bundle.

Deployment Pipeline

Data flows from the local development environment through an automated build cycle to the final production container.

graph LR
    A[Code] --> B(Build Pipeline)
    B --> C{Optimization}
    C -->|Bundled| D[Static Distribution]
    C -->|Images| E[Asset Storage]
    D --> F[Nginx Container]
    E --> F
    F --> G((Production Site))

Credits

This entire ecosystem, from the low-level architecture to the high-level design systems, was engineered and curated solely by Ahmad Hassan (B-Ted).

New collaborators or interested parties are welcomed to explore the codebase and learn more about the technical decisions behind the build.


Designing with Pixels, Coding with Precision.
© 2026 Ahmad Hassan (B-Ted)

PortfolioWebsite (AhmadHassan-BTed/PortfolioWebsite)

Ищем в базе…

Что это такое?Это личный портфолио-сайт Ахмада Хассана (B-Ted), где он представляет свои работы в области разработки программ и графического дизайна, а также свои проекты, историю и резюме.
Это полноценное веб-приложение или просто статичный сайт?Это простой многостраничный статичный сайт, написанный на HTML, CSS и базовом JavaScript и собираемый через Vite для оптимизированных production-сборок.
Как запустить это локально?Клонируйте репозиторий, выполните 'npm install', чтобы установить зависимости, затем 'npm run dev', чтобы запустить сервер разработки, или 'npm run build', чтобы собрать production-версию.
Нужны ли Node.js или Docker, чтобы это запустить?Нужен Node.js версии 18.0 или выше; Docker необязателен и понадобится только для тестирования в контейнерах или для развёртывания через входящий в состав образ Nginx.
Зачем статичному портфолио-сайту Dockerfile?Чтобы гарантировать одинаковое развёртывание в разных окружениях: production-сборка отдаётся через лёгкий образ Nginx внутри Docker-контейнера.
Что я найду на самом сайте?Там представлены проекты Ахмада, его личная история и резюме, с акцентом на отточенный высококачественный UI/UX.
Размер
39.7 MB
Звёзды
4K
Обновлён
КоммитJun 30
Возраст
3 г
Коммиты · 90 дней