An open API service indexing awesome lists of open source software.

https://github.com/sb-ccl/modern-portfolio

A production-optimized React portfolio achieving 98% accessibility and 82% SEO Lighthouse scores, delivered through automated Vercel CI/CD pipelines. Features dynamic theming, micro-interactions, and WCAG 2.1 compliant interfaces.
https://github.com/sb-ccl/modern-portfolio

css html5 javascript magic-ui react-js react-router-dom shadcn-ui tailwind-css vercel-deployment vite-js

Last synced: 3 months ago
JSON representation

A production-optimized React portfolio achieving 98% accessibility and 82% SEO Lighthouse scores, delivered through automated Vercel CI/CD pipelines. Features dynamic theming, micro-interactions, and WCAG 2.1 compliant interfaces.

Awesome Lists containing this project

README

        

# 🌐 Modern Portfolio

[![React](https://img.shields.io/badge/React-20232a?style=flat&logo=react)](https://react.dev/)
[![Vite](https://img.shields.io/badge/Vite-B73BFE?style=flat&logo=vite&logoColor=FFD62E)](https://vitejs.dev/)
[![TailwindCSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=flat&logo=tailwind-css)](https://tailwindcss.com/)
[![Node.js](https://img.shields.io/badge/Node.js-43853D?style=flat&logo=node.js&logoColor=white)](https://nodejs.org/)
[![ShadCN UI](https://img.shields.io/badge/ShadCN_UI-000000?style=flat&logoColor=white)](https://ui.shadcn.com/)
[![Lighthouse](https://img.shields.io/badge/best%20practices-100%25-success?style=flat-square&logo=google-chrome&logoColor=white)](https://)
[![Lighthouse](https://img.shields.io/badge/accessibility-98%25-brightgreen?style=flat-square&logo=accessibility&logoColor=white)](https://)
[![Package Manager](https://img.shields.io/badge/pkg%20manager-npm%20%7C%20yarn-orange)]()

[![Live Demo](https://img.shields.io/badge/vercel-live%20demo-%23000000.svg?style=for-the-badge&logo=vercel&logoColor=white)](https://sb-modern-portfolio.vercel.app/)

![Project Screenshot](https://github.com/Sb-CCL/Modern-Portfolio/blob/main/public/portfolio-preview.png?raw=true)

A production-optimized React portfolio achieving 98% accessibility and 82% SEO Lighthouse scores, delivered through automated Vercel CI/CD pipelines. Features dynamic theming, micro-interactions, and WCAG 2.1 compliant interfaces.

## ✨ Key Features

- **🎨 Dynamic Theming & Animations:** System-aware dark/light mode with seamless transitions using Next-Themes and Framer Motion micro-interactions
- **πŸš€ Performance Optimized:** Vite-powered development with code splitting, lazy loading, and production-ready Vercel deployment
- **β™Ώ Accessibility First:** WCAG 2.1 compliant with a 98 Lighthouse score, featuring fully keyboard-navigable interfaces
- **🌍 SEO Architecture:** Structured data and semantic HTML implementation achieving 82 Lighthouse score
- **πŸ“± Responsive Design:** Fluid layouts and adaptive components across all device sizes
- **⚑ Modern Tech Stack:** Built with ShadcnUI components, custom Tailwind variants, and React best practices
- **πŸ”„ Automated Deployment:** Vercel CI/CD pipeline with automatic preview deployments, branch protections, and production rollbacks

## πŸ“Š Lighthouse Results

| Category | Score | Audit Summary |
| -------------- | ----- | --------------------------------- |
| Performance | 89 | Optimized assets and lazy loading |
| Accessibility | 98 | ARIA labels and semantic markup |
| Best Practices | 100 | Modern APIs and secure headers |
| SEO | 82 | Structured data and meta tags |

## ⚑ Quick Start

### Prerequisites

- **Node.js** (v16.x or higher)
- **npm** (v8.x or higher) or Yarn (v1.22.x or higher)

### Installation

1. Clone the repository:

```bash
git clone https://github.com/Sb-CCL/Modern-Portfolio.git
cd Modern-Portfolio
```

2. Install dependencies:

```bash
npm install # Using npm
# or
yarn # Using Yarn
```

3. Start the development server:

```bash
npm run dev # Using npm
# or
yarn dev # Using Yarn
```

## πŸ–Ώ Project Structure

```bash
β”œβ”€β”€ public/
β”‚ └── screenshot.png
β”‚ └── project-videos.mp4
β”‚ └── favicon.png
β”œβ”€β”€ src/
β”‚ β”œβ”€β”€ assets/ # Static resources
β”‚ β”œβ”€β”€ components/ # Reusable components
β”‚ β”‚ β”œβ”€β”€ ui/ # Radix-based primitives
β”‚ β”‚ └── sections/ # Page sections
β”‚ β”œβ”€β”€ hooks/ # Custom hooks
β”‚ β”œβ”€β”€ lib/ # Utilities/configs
β”‚ β”œβ”€β”€ pages/ # Route components
β”‚ β”œβ”€β”€ styles/ # Global CSS
β”‚ └── main.jsx # Application entry
β”œβ”€β”€ .eslintrc.cjs # Linting rules
β”œβ”€β”€ tailwind.config.js # Tailwind config
└── vite.config.js # Build configuration
```

### πŸ“œ Development

| Script | Description |
| ----------------- | ------------------------------------ |
| `npm run dev` | Start the development server |
| `npm run build` | Build the application for production |
| `npm run preview` | Preview the production build |
| `npm run lint` | Run ESLint to check code quality |

## β™Ώ Accessibility

This project prioritizes accessibility to ensure a better user experience for all users, including those with disabilities. The following practices and tools have been integrated:

## πŸ“ˆ Performance

This app leverages Vite for **lightning-fast development** and **build times**. It’s optimized for modern browsers, ensuring **high performance** and **low initial load times**.

## πŸ“„ License

This project is proprietary software. Unauthorized use, modification, or distribution is strictly prohibited. For licensing inquiries, contact the repository owner.