Portfolio Framework (Astro + Manfred)

A high-performance, schema-driven portfolio generated from a single JSON source.

Live at: clystian.ninja | clystian.github.io

---

🏗 Architecture & Tech Stack

• Framework: Astro 4.x (SSG)
• Styling: Tailwind CSS
• Package Manager: pnpm
• Data Schema: Manfred MAC (src/data/manfred.json)

Why Manfred?

The site implements a Data-First approach. By using the Manfred MAC schema, the resume data is decoupled from the UI logic, allowing for easy updates and interoperability with other HR tools.

---

🚀 Getting Started

Prerequisites

• Node.js (Latest LTS)
• pnpm corepack enable pnpm

Installation

pnpm install

Local Development

pnpm dev

Build & Validation

# Validates types and builds the static site to /dist
pnpm run build

# Execute Playwright/Vitest suite
pnpm test

---

🛠 Content Management

To update the portfolio content, modify the source of truth:

1. Edit public/manfred.json (or src/data/manfred.json depending on your setup).

2. The UI components reactively map the JSON nodes to Tailwind-styled components.

3. Commit changes to main to trigger the GitHub Actions deployment.

---

📦 Deployment

This repository uses GitHub Actions for automated deployment.

• Branch: main triggers the build.

• Environment: GitHub Pages.

• Custom Domain: Configured via CNAME in the public/ directory.

📄 License

The CVs included in this repository contain my personal and professional data, and they can't be automatically processed without my explicit permission according to the GDPR (General Data Protection Regulation).

The MAC format is free and open-source software licensed and distributed under the Creative Commons Attribution Share Alike 4.0 International (CC BY-SA 4.0 International).