From 03732840c9d86bb581bc2fd07420403c96c2d054 Mon Sep 17 00:00:00 2001
From: trafficlunar <hello@trafficlunar.net>
Date: Fri, 25 Apr 2025 21:14:41 +0100
Subject: [PATCH] docs: update README

---
 README.md | 30 +++++++++++++++++++++++++++---
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 4143124..204af00 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,34 @@
 <p align="center">
-  todo: tomodachi-share logo
+  <img src="public/logo.svg" alt="TomodachiShare Logo" width="128" />
+</p>
+
+<h1 align="center"><a href="https://tomodachi-share.trafficlunar.net">TomodachiShare</a></h1>
+
+<p align="center">
+  <b>Discover and share Mii residents for your Tomodachi Life island!</b>
 </p>
 
 <p align="center">
   <a href="https://tomodachi-share.trafficlunar.net"><img src="https://raw.githubusercontent.com/intergrav/devins-badges/refs/heads/v3/assets/cozy/documentation/website_vector.svg" alt="Visit the website" /></a>
   <a href="https://trafficlunar.net"><img src="https://raw.githubusercontent.com/trafficlunar/trafficlunar/refs/heads/main/trafficlunar-cozy-minimal_vector.svg" alt="Visit my personal website" /></a>
-
-  <p align="center">Share your Tomodachi Life Miis!</p>
+</p>
+
+---
+
+## About
+
+**TomodachiShare** is a fan-made website that lets you easily discover, upload, and share **Mii characters** for the game **Tomodachi Life**.
+
+- 📷 Upload or scan your Mii QR codes
+- ✨ Generates Mii renders for previews
+- 🖼️ Add custom images of your Mii on your island
+- 🌎 Browse and add Miis from other players
+- 🏝️ Build your perfect island by finding the perfect residents
+
+---
+
+<p align="center">
+  <sub align="center">
+    <i>Tomodachi Life and Mii characters are trademarks of Nintendo. This project is fan-made and not affiliated with Nintendo.</i>
+  </sub>
 </p>