Skip to content

mCodex/mcodex.github.io

Repository files navigation

mCodex Portfolio

GitHub Pages Next.js TypeScript React

Personal portfolio website showcasing my open-source projects and skills as a Full-Stack Developer with expertise in React Native, React.js, and Node.js.

🚀 Live Demo

Visit the live portfolio at: mcodex.dev

✨ Features

  • Responsive Design: Optimized for all device sizes
  • Modern Tech Stack: Built with Next.js 15, React 19, and TypeScript
  • GitHub Integration: Automatically showcases OSS projects with live stats
  • Performance Optimized: Utilizes Turbopack for fast builds
  • SCSS Modules: Clean, modular styling
  • Smooth Animations: Enhanced UX with smooth scrolling and transitions

🛠️ Tech Stack

  • Framework: Next.js 15.4.6 with App Router
  • Language: TypeScript 5.x
  • Styling: SCSS with CSS Modules
  • Icons: React Icons
  • Build Tool: Turbopack
  • Deployment: GitHub Pages

📂 Featured Projects

This portfolio showcases several open-source projects including:

🏃‍♂️ Quick Start

Prerequisites

  • Node.js (v18 or higher)
  • npm, yarn, pnpm, or bun

Installation

  1. Clone the repository:
git clone https://github.com/mCodex/mcodex.github.io.git
cd mcodex.github.io
  1. Install dependencies:
npm install
# or
yarn install
# or
pnpm install
  1. Run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev
  1. Open http://localhost:3000 in your browser.

📦 Build Commands

# Development with Turbopack
npm run dev

# Production build
npm run build

# Build for GitHub Pages deployment
npm run build:gactions

# Start production server
npm run start

# Lint code
npm run lint

🌐 Deployment

This project is configured for GitHub Pages deployment with automatic builds via GitHub Actions:

  1. The build:gactions script creates an optimized build
  2. Adds .nojekyll file for proper GitHub Pages serving
  3. Copies CNAME for custom domain support

📄 License

This project is open source and available under the MIT License.


If you find this portfolio inspiring, please give it a star!

About

My website built using NextJS + Styled Components

Topics

Resources

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •