Favour Kelvin — Portfolio Site

Personal portfolio site built with Astro and deployed to Vercel.

Prerequisites

• Node.js 18 or later
• npm

Getting Started

# Install dependencies
npm install
# Start the dev server
npm run dev

Open http://localhost:4321 to view the site.

Build

npm run build

This generates a static site in the dist/ directory.

Project Structure

src/
components/ → Astro and React components (WritingSamples, PortfolioFeed, etc.)
content/
portfolio/ → Case study posts (.mdx)
posts/ → Blog posts (.mdx)
layouts/ → Base layout
pages/
├── index.astro → Home page
├── about.astro → About page
├── resume.astro → Resume/CV
├── portfolio/ → Portfolio listing + dynamic routes
├── writing-samples.astro → Filterable writing samples grid
└── posts/ → Blog listing + dynamic routes
styles/ → Global CSS
public/
├── images/ → Screenshots and thumbnails
└── downloads/ → PDF writing samples and resume

Adding Content

Portfolio posts: Add an .mdx file in src/content/portfolio/.

Writing samples: Add entries to the samples array in src/components/WritingSamples.jsx. Place PDFs in public/downloads/ and thumbnails in public/images/samples/.

Blog posts: Add .mdx files in src/content/posts/.

Deployment

Pushing to main triggers automatic deployment on Vercel. Astro is auto-detected — no extra config needed.

Placeholders

The following files need to be added manually:

• Screenshot images in public/images/portfolio/ and public/images/samples/ (see public/images/README.md)
• PDF writing samples in public/downloads/ (see public/downloads/README.md)
• Resume PDF at public/downloads/favour-kelvin-cv.pdf