diff --git a/README.md b/README.md
index 88b97b5..2aa9806 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,109 @@
-# Test
+# Hi there, I'm [Your Name] 👋
 
+<!-- 
+  ============================================================
+  SETUP INSTRUCTIONS
+  ============================================================
+  1. Replace every instance of:
+       git.rcslabs.dev  →  e.g. codeberg.org or forgejo.myserver.com
+       john4064  →  your Forgejo username
+       John      →  your display name
+  
+  2. For the dynamic stats SVGs (overview + languages cards),
+     follow the forgejo-stats setup guide:
+     https://codeberg.org/Tuxilio/forgejo-stats
+     Then update the image src URLs to point to your own
+     forgejo-stats repo.
+
+  3. Delete this comment block when you're done.
+  ============================================================
+-->
+
+## About me
+
+- 🔭 Currently working on &nbsp;**[project name](https://git.rcslabs.dev/john4064/YOUR_REPO)**
+- 🌱 Learning &nbsp;**[technology / topic]**
+- 💬 Ask me about &nbsp;**[your expertise]**
+- 📫 Reach me at &nbsp;**[your@email.com]** &nbsp;or &nbsp;**[@handle@mastodon.instance](https://mastodon.instance/@handle)**
+- 🌍 Website / blog: &nbsp;**[yoursite.com](https://yoursite.com)**
+
+---
+
+## Stats
+
+<!--
+  OPTION A — forgejo-stats (recommended, includes private repos)
+  --------------------------------------------------------------
+  Fork https://codeberg.org/Tuxilio/forgejo-stats into your own
+  Forgejo instance, configure CI secrets, and point the src
+  URLs below at your generated/ folder.
+
+  OPTION B — skip the stats cards and rely only on shields.io
+  badges further down this file.
+-->
+
+<div align="center">
+  <a href="https://git.rcslabs.dev/john4064/forgejo-stats">
+    <img
+      src="https://git.rcslabs.dev/john4064/forgejo-stats/media/branch/main/generated/overview.svg"
+      alt="Profile overview stats"
+    />
+    <img
+      src="https://git.rcslabs.dev/john4064/forgejo-stats/media/branch/main/generated/languages.svg"
+      alt="Top languages"
+    />
+  </a>
+</div>
+
+---
+
+## Featured projects
+
+<!-- 
+  Forgejo renders repo cards natively on your profile page via
+  pinned repos (set them in Settings → Profile).  The links
+  below are an extra layer of visibility inside the README itself.
+-->
+
+| Project | Description | Stars | Last commit |
+|---------|-------------|-------|-------------|
+| [repo-one](https://git.rcslabs.dev/john4064/repo-one) | Short description | ![stars](https://img.shields.io/gitea/stars/john4064/repo-one?gitea_url=https%3A%2F%2Fgit.rcslabs.dev&style=flat-square) | ![last commit](https://img.shields.io/gitea/last-commit/john4064/repo-one?gitea_url=https%3A%2F%2Fgit.rcslabs.dev&style=flat-square) |
+| [repo-two](https://git.rcslabs.dev/john4064/repo-two) | Short description | ![stars](https://img.shields.io/gitea/stars/john4064/repo-two?gitea_url=https%3A%2F%2Fgit.rcslabs.dev&style=flat-square) | ![last commit](https://img.shields.io/gitea/last-commit/john4064/repo-two?gitea_url=https%3A%2F%2Fgit.rcslabs.dev&style=flat-square) |
+| [repo-three](https://git.rcslabs.dev/john4064/repo-three) | Short description | ![stars](https://img.shields.io/gitea/stars/john4064/repo-three?gitea_url=https%3A%2F%2Fgit.rcslabs.dev&style=flat-square) | ![last commit](https://img.shields.io/gitea/last-commit/john4064/repo-three?gitea_url=https%3A%2F%2Fgit.rcslabs.dev&style=flat-square) |
+
+---
+
+## Tech stack
+
+<!-- Replace or remove any badges that don't apply to you -->
+
+### Languages
+![Go](https://img.shields.io/badge/Go-00ADD8?style=flat-square&logo=go&logoColor=white)
+![Python](https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white)
+![Rust](https://img.shields.io/badge/Rust-000000?style=flat-square&logo=rust&logoColor=white)
+![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)
+![Shell](https://img.shields.io/badge/Shell-121011?style=flat-square&logo=gnu-bash&logoColor=white)
+
+### Tools & platforms
+![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white)
+![Linux](https://img.shields.io/badge/Linux-FCC624?style=flat-square&logo=linux&logoColor=black)
+![Forgejo](https://img.shields.io/badge/Forgejo-FB923C?style=flat-square&logo=forgejo&logoColor=white)
+![Woodpecker CI](https://img.shields.io/badge/Woodpecker_CI-4CAF50?style=flat-square&logo=woodpecker-ci&logoColor=white)
+
+---
+
+## Activity
+
+<!--
+  Forgejo does not yet have a native contribution graph embeddable
+  in READMEs.  If your instance exposes the API publicly you can
+  link to your activity feed as a fallback.
+-->
+
+📅 &nbsp;[View my recent activity](https://git.rcslabs.dev/john4064?tab=activity)
+
+---
+
+<p align="center">
+  <sub>Profile generated with <a href="https://codeberg.org/Tuxilio/forgejo-stats">forgejo-stats</a> · Hosted on <a href="https://git.rcslabs.dev">git.rcslabs.dev</a></sub>
+</p>
\ No newline at end of file