🔗 portfolio-jirihofman.vercel.app

My personal portfolio website, built with Next.js, Tailwind CSS and deployed to Vercel. Based on chronark's site. Some ideas borrowed from leerob/leerob.io.

It is supposed to be used as a template for other GitHub users' portfolios. Data about user and projects are gathered via GitHub and Vercel API.

Tech stack

• Framework: Next.js 16.1.1
• Deployment: Vercel
• Styling: Tailwind CSS 4.1.12
• UI: React 19.2.3

Project Information Features

The portfolio automatically displays comprehensive information for each repository in the /projects page. Here's what visitors can expect to see for each project:

Repository Details

• Project name with gradient styling and clickable links
• Description from GitHub repository
• Creation date showing when the project was started
• Star count with compact number formatting
• GitHub repository link for easy access to source code

Repository Analytics (for your own repositories)

• Visitor statistics: Unique repository visitors in the last 14 days and today
• Security alerts: Dependabot alerts categorized by severity (critical, high, medium, low)
• AI assistance: Count of merged Copilot pull requests in the last 2 weeks

Deployment & Technology Detection

• Vercel integration: Shows deployment status, Node.js version, and framework info
• Framework detection:
  • Next.js projects with Pages Router, App Router, or hybrid detection
  • Turbopack usage indicator
  • Next.js version upgrade recommendations
• UI library detection: Automatically identifies Tailwind CSS, React Bootstrap, Primer, and other libraries from package.json

Data Sources

• GitHub API: Repository information, traffic data, security alerts, pull requests
• Vercel API: Deployment information and project details
• GraphQL queries: Pinned repositories and organization data

All data is cached and refreshed automatically to ensure good performance while providing up-to-date information.

Running Locally

git clone https://github.com/jirihofman/portfolio.git
cd portfolio

Environment variables

Create a .env.local file similar to .env.example.

cp .env.example .env.local

Add your tokens to the .env.local file:

# Required: GitHub Personal Access Token (needed for build-time API calls to fetch user data)
GH_TOKEN=YOUR_GH_TOKEN

# Optional: Vercel token to display deployment information
VC_TOKEN=YOUR_VERCEL_TOKEN

# Optional: Set to false when using your own data in data.json
IS_TEMPLATE=true

Note: GH_TOKEN is required for the application to build and run. The build process makes GitHub API calls to fetch your username and repository data. Without a valid token, the build will fail.

Then install dependencies and run the development server:

# Install dependencies.
npm install
# Replace jirihofman's personal info with octocat's.
npm run setup
# Start hacking.
npm run dev

Edit data.json to put your personal information there.

Cloning / Forking

When using this template for your own portfolio:

1. Run npm run setup to replace the default personal information in data.json with template data
2. Edit data.json with your own information (githubUsername, description, heroNames)
3. Set IS_TEMPLATE=false in your .env.local file to prevent future builds from reverting your changes
4. Update the following files with your information:
   • [ ] README.md: Update the link at the top
   • [ ] app/layout.jsx: Update metadata (title, description, favicon) - handled by setup.mjs
   • [ ] public/favicon.ico: Add your own favicon - handled by setup.mjs

Removing Template Functionality

After cloning or forking this repository, you may want to remove all template-specific functionality and references to the original author. This will prepare the repository to be your own personal portfolio without any template reversion logic.

Using GitHub Copilot or AI Agent:

If you have access to GitHub Copilot Workspace or another AI coding agent, you can use the removal prompt:

# Copy the prompt content and provide it to your AI agent
cat .github/prompts/remove-template.md

The AI agent will:

• Remove template reversion logic from lib/setup.mjs
• Remove all references to jirihofman
• Eliminate IS_TEMPLATE environment variable usage
• Clean up README to focus on personal portfolio use
• Prepare the repository for your personal use without template features

Manual Removal:

If you prefer to remove template functionality manually, follow the detailed instructions in .github/prompts/remove-template.md.