CodeStorm Hub Portfolio Website

CodeStorm Hub is a vibrant community of open source enthusiasts, researchers, and creators. We collaborate on powerful open-source solutions.

This is the official portfolio website built with Next.js, Tailwind CSS, and Radix UI, featuring a modern design system inspired by Vercel's design engineering practices.

Tech Stack

• Framework: Next.js 15 with App Router
• Styling: Tailwind CSS 4 and Radix Colors
• Components: Radix UI and Radix Icons
• Typography: Geist Font
• Language: TypeScript
• Deployment: GitHub Pages (automated via GitHub Actions)

Getting Started

First, install dependencies:

npm install

Then, run the development server:

npm run dev

Open http://localhost:3000 with your browser to see the result.

Project Structure

src/
├── app/                    # Next.js App Router pages
├── components/             # Reusable UI components
├── lib/                    # Utilities and configurations
└── styles/                 # Global styles and design tokens

Design System

This project implements a comprehensive design system based on:

• Radix Colors for consistent color palettes
• Radix UI Primitives for accessible components
• Vercel Design principles and patterns

Development

Environment Setup

1. Copy the environment example file:

cp .env.example .env.local

2. Install dependencies:

npm install

Available Scripts

• npm run dev - Start development server with Turbopack
• npm run build - Build for production (GitHub Pages optimized)
• npm run start - Start production server
• npm run lint - Run ESLint with auto-fix
• npm run type-check - Run TypeScript type checking
• npm run dev:clean - Clean build cache and start dev server

Code Quality

This project enforces strict code quality standards:

• TypeScript strict mode
• ESLint with Next.js recommended rules
• Accessibility compliance (WCAG 2.1 AA)
• Performance optimization (Core Web Vitals)

Deployment

This project supports two deployment methods:

GitHub Pages (Recommended)

The site is automatically deployed to GitHub Pages when changes are pushed to the main branch.

• Live Site: codestorm-hub.github.io
• Deployment: Automatic via GitHub Actions
• Configuration: See GitHub Pages Deployment Guide

Vercel

Alternative deployment platform with similar capabilities.

• Configuration: vercel.json included for Vercel deployments

Contributing

We welcome contributions! Please see our contributing guidelines for more details.

License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.