Skip to content

pvcodes/portfolio

 
 

Repository files navigation

Personal Website & Blog

A modern, responsive personal website and blog built with Next.js. Features a clean design, blog functionality with MDX support, and automated GitHub Pages deployment.

Live Site

https://yashagw.github.io/

Quick Start Guide

1. Clone and Setup

git clone https://github.com/yashagw/yashagw.github.io.git
cd yashagw.github.io

2. Install Dependencies

npm install

3. Run Development Server

npm run dev
# Visit http://localhost:3000

4. Add Blog Posts

Create new posts in content/blog/ as Markdown files:

+++
title = "Your Blog Post Title"
date = 2024-01-15
taxonomies = { tags = ["tag1", "tag2"] }
+++

Your content here...

5. Build for Production

npm run build

Deployment

  1. Fork this repository and rename to yourusername.github.io
  2. Enable GitHub Pages in repository settings → Pages → Source: "GitHub Actions"
  3. Push to main branch - the included workflow will auto-deploy

Project Structure

  • app/ - Next.js App Router pages and layouts
  • components/ - React components
  • content/blog/ - Blog posts (Markdown)
  • lib/ - Utility functions
  • public/ - Static assets (images, icons)

Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run start - Start production server
  • npm run lint - Run ESLint

Contributing

Fork and use as a template for your own site!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 89.3%
  • CSS 10.4%
  • JavaScript 0.3%