diff --git a/README.md b/README.md
index fc77e09..40c5d73 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,89 @@
-# **contentport — public roadmap (last updated: 29th Nov 2025)**
+<!-- PROJECT LOGO -->
+<p align="center">
+  <a href="https://github.com/contentport">
+   <img src="https://www.contentport.io/logo.png" alt="Contentport Logo" width="120">
+  </a>
+
+  <h3 align="center">Contentport</h3>
+
+  <p align="center">
+    Your content engine for growing on Twitter
+    <br />
+    <a href="https://www.contentport.io"><strong>Create and schedule Twitter content at scale »</strong></a>
+    <br />
+    <br />
+    <a href="https://www.contentport.io">Website</a>
+    ·
+    <a href="https://www.contentport.io/features">Features</a>
+    ·
+    <a href="https://github.com/contentport/issues">Issues</a>
+    ·
+    <a href="https://www.contentport.io/pricing">Pricing</a>
+  </p>
+</p>
+
+<p align="center">
+   <a href="https://www.contentport.io"><img src="https://img.shields.io/badge/Website-contentport.io-2ea44f" alt="Website"></a>
+   <a href="https://twitter.com/contentport"><img src="https://img.shields.io/badge/Twitter-@contentport-1DA1F2?logo=twitter" alt="Twitter"></a>
+   <a href="https://github.com/contentport"><img src="https://img.shields.io/badge/Open%20Source-100%25-brightgreen" alt="Open Source"></a>
+</p>
+
+<p align="center">
+   <a href="https://github.com/contentport/stargazers"><img src="https://img.shields.io/github/stars/contentport" alt="Github Stars"></a>
+   <a href="https://github.com/contentport/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
+</p>
 
-## **Features in Pipeline**
+---
+
+# contentport
+
+## Getting Started
+
+> **Note:** This is a WIP and not comprehensive. Please contribute an improvement if you want to help others get started or us to offer a better onboarding experience.
+
+### Prerequisites
+
+- **`DATABASE_URL`** — A serverless Postgres database. This project uses Drizzle with the PostgreSQL dialect.
+  <a href="https://console.neon.tech/signup"><img src="https://img.shields.io/badge/Sign%20up-Neon%20Database-00e599?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyQzYuNDggMiAyIDYuNDggMiAxMnM0LjQ4IDEwIDEwIDEwIDEwLTQuNDggMTAtMTBTMTcuNTIgMiAxMiAyeiIvPjwvc3ZnPg==" alt="Sign up for Neon" /></a>
+
+  Or, if you prefer the CLI: `neonctl databases create --name contentport` ([Neon CLI docs](https://neon.com/docs/reference/cli-databases))
+
+- **`NEXT_PUBLIC_POSTHOG_KEY`** — A PostHog project API key for analytics.
+  <a href="https://us.posthog.com/signup"><img src="https://img.shields.io/badge/Sign%20up-PostHog-1d4aff?style=for-the-badge&logo=posthog&logoColor=white" alt="Sign up for PostHog" /></a>
+
+### Follow along
+
+1. **Download the source code.** Clone the repo locally:
+   ```bash
+   gh repo clone joschan21/contentport
+   # or via HTTPS
+   git clone https://github.com/joschan21/contentport.git
+   ```
+2. **Configure secrets.** Set environment variables:
+   ```bash
+   cp .env.example .env
+   ```
+   Then fill in the keys obtained from [Prerequisites](#prerequisites) (at minimum `DATABASE_URL`).
+3. **Install dependencies:**
+   ```bash
+   bun i
+   ```
+4. **Push the database schema:**
+   ```bash
+   bun db:push
+   ```
+5. **Run the development server:**
+   ```bash
+   bun dev
+   ```
+
+---
+
+## **Public Roadmap** (last updated: 29th Nov 2025)
+
+### **Features in Pipeline**
 
-### **Priority 1**
+#### **Priority 1**
 
 * Dark mode (requested by many users)
 * Responsive layout (requested by many users)
@@ -32,7 +113,7 @@
 
 ---
 
-### **Priority 2**
+#### **Priority 2**
 
 * Switch between different LLMs — personal wish (Jo)
 * Personalized example ideas (similar to the OpenAI Atlas Browser) — requested by many
@@ -40,14 +121,14 @@
 
 ---
 
-### **Priority 3**
+#### **Priority 3**
 
 * Viral tweet library (potentially useful feature)
 * Enable web browsing (potentially useful feature)
 
 ---
 
-## **Bugs**
+### **Bugs**
 
 * Timezone issues / “-1 days” calendar error
 * Creating transcripts from videos
@@ -56,7 +137,7 @@
 
 ---
 
-## **Improvements**
+### **Improvements**
 
 * Assistant style handling
 * Upgrade modal / paywall / email flow