Sample Project

Overview

This is a sample project post that demonstrates how to write a portfolio entry. Replace this content with your own — the structure is just a suggestion.

A good post typically answers three questions:

1. What was the problem? — What were you trying to solve or build?
2. How did you approach it? — What decisions did you make and why?
3. What was the outcome? — What did you learn, and what would you do differently?

---

The Problem

Describe the problem or goal here. Be specific — a concrete problem statement is more interesting than a vague one.

“I needed to build a REST API that could handle 10,000 concurrent requests without exceeding 100ms p99 latency on a single €5/month VPS.”

---

Approach

Walk through the key decisions you made. If you considered multiple options, say so — the reasoning is often more valuable than the final answer.

Architecture diagram

Key implementation

Here is an example Python function with syntax highlighting:

import asyncio
from typing import AsyncGenerator

async def stream_response(data: list[dict]) -> AsyncGenerator[str, None]:
    """Yield JSON-serialised records one at a time."""
    for record in data:
        yield json.dumps(record) + "\n"
        await asyncio.sleep(0)   # yield control to the event loop

And a TypeScript example:

export async function fetchPosts(tag?: string) {
  const posts = await getCollection('projects');
  return posts
    .filter((p) => !tag || p.data.tags.includes(tag))
    .sort((a, b) => b.data.publishDate.valueOf() - a.data.publishDate.valueOf());
}

---

Results

Summarise what you achieved. Numbers are great if you have them.

• Reduced average response time from 340ms → 42ms by adding an in-memory cache
• Reduced Docker image size from 1.2GB → 180MB with a multi-stage build
• Zero downtime deploys via a rolling restart script

---

Lessons learned

• Premature optimisation is real — profile before you rewrite
• Good error messages save hours of debugging; invest in them early
• Writing a post like this forces you to understand what you built at a deeper level