My Personal Website

This is my personal website and portfolio, built with Next.js, shadcn/ui, and magic ui, deployed on Vercel.

Features

• Showcases my personal projects, skills, and experiences
• Includes a blog where I share my thoughts and insights
• Responsive design for optimal viewing on different devices
• Built using Next.js 14, React, Typescript, Shadcn/UI, TailwindCSS, Framer Motion, Magic UI
• Optimized for performance with Next.js and Vercel

Customization

The website can be easily customized by editing the single config file to reflect your own information and preferences.

Local Development

To run this website locally:

1. Clone this repository:

   git clone https://github.com/ameyxd/portfolio

2. Navigate to the project directory:

   cd portfolio

3. Install dependencies:

   pnpm install

4. Start the development server:

   pnpm dev

5. Open the Config file and customize it with your personal information

License

This project is licensed under the MIT license.

Portfolio & Blog

Blog Post Workflow

1. Create Content

• Create new MDX file in content/posts/your-post.mdx
• Add frontmatter with required metadata:

  ---
  title: Your Post Title
  publishedAt: YYYY-MM-DD
  description: Brief description
  tags: [tag1, tag2]
  ---

2. Add Images

• Place images in content/images/ directory
• Reference in MDX: ![alt text](/images/your-image.jpg)

3. Test Locally

3.1 Test build process

pnpm test:all

3.2 Run development server

pnpm dev

4. Publishing Flow

1. Create new branch for your post:

   git checkout -b post/your-post-name

2. Commit changes:

   git add .
   git commit -m "post: add new blog post about X"

3. Push and test build:

   git push origin post/your-post-name

4. Create PR to master

   • Wait for build to pass
   • Review preview
   • Merge to master

5. Master branch will automatically:

   • Build
   • Deploy to GitHub Pages
   • Process images

5. Development & Branch Strategy

Branch Structure

• master: Production-ready code only
• develop: Integration branch for features
• post/*, feature/*: Individual branches from develop

New Post/Feature Workflow

1. Ensure develop is stable

   git checkout develop
   git pull origin develop
   pnpm ci:local
   git push origin develop
   # Wait for GitHub Actions to pass

2. Create new branch

   git checkout -b post/your-post-name
   # or
   git checkout -b feature/your-feature

3. Work on changes

   • Add/edit content
   • Test locally with pnpm dev
   • Run pnpm ci:local to test build (optional - will run automatically on push)

4. Commit and push

   git add .
   git commit -m "post: add new blog post about X"
   git push origin post/your-post-name

   Note: Pre-push hook will automatically run CI checks before pushing

5. Create Pull Request

   • Create PR from your branch to develop
   • Wait for GitHub Actions to pass
   • Get review if needed
   • Merge to develop

6. Final Production Deploy

   • Once develop is stable, create PR from develop to master
   • Wait for GitHub Actions to pass
   • Merge to master for production deployment

7. Cleanup

   git checkout develop
   git pull origin develop
   git branch -d post/your-post-name

CI/CD Notes

• Local CI checks run automatically before each push
• GitHub Actions run on PRs to develop and master
• Builds must pass before merging
• Master branch deploys automatically to production