From fb4688f65235c56239b4816eb81b276fa2b0ca3c Mon Sep 17 00:00:00 2001
From: "nate@necloud.us" <nate@necloud.us>
Date: Wed, 2 Jul 2025 10:06:41 -0400
Subject: [PATCH] readme

---
 Read me.md | 64 ------------------------------------------------------
 Readme.md  | 45 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 45 insertions(+), 64 deletions(-)
 delete mode 100644 Read me.md
 create mode 100644 Readme.md

diff --git a/Read me.md b/Read me.md
deleted file mode 100644
index 0451119..0000000
--- a/Read me.md	
+++ /dev/null
@@ -1,64 +0,0 @@
-### Spelling Game ###
-
----
-
-### 🐳 **How to Clone and Run the Spelling App from Gitea with Docker Compose**
-
-1. **Install Docker & Docker Compose**
-   - Mac: [Docker Desktop for Mac](https://www.docker.com/products/docker-desktop/)
-   - Windows: [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)
-   - Linux: Use your package manager (e.g. `apt install docker docker-compose`)
-
-2. **Clone the Repository**
-
-```bash
-git clone https://git.necloud.us/nmemmert/Spelling.git
-cd Spelling
-```
-
-3. **Build & Start the Container**
-
-```bash
-docker-compose up --build
-```
-
-This will:
-- Build the Docker image using the included `Dockerfile`
-- Start the container on port 3000
-- Mount your user data (like `users.json` and `wordlists.json`) so they persist
-
-4. **Access the App**
-
-Open your browser and visit:
-
-```
-http://localhost:3000
-```
-
-🎉 You’re in! Log in with a predefined user from `users.json` (e.g., `admin1` / `password`).
-
-5. **Stop the App**
-
-To shut it down when you're done:
-
-```bash
-docker-compose down
-```
-
----
-
-### ✅ Optional: Run in the Background
-
-```bash
-docker-compose up -d
-```
-
-To stop it later:
-
-```bash
-docker-compose down
-```
-
----
-
-Want me to generate a `README.md` from this? Or help automate updates with a webhook from your Gitea server? You’re primed for self-hosted greatness.
\ No newline at end of file
diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..cca834b
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,45 @@
+# 📝 Spelling App
+
+A lightweight, multi-user spelling practice app with admin controls, customizable themes, and per-user word list management. Built with Node.js, Express, and Docker.
+
+---
+
+## 🚀 Quick Start (Docker Compose)
+
+Clone and run from anywhere using Docker Compose:
+
+```bash
+git clone https://git.necloud.us/nmemmert/Spelling.git
+cd Spelling
+docker-compose up --build
+
+👥 Default Login
+Username	Password	Role
+admin1	password	Admin
+student1	123456	Student
+You can add new users from the Admin Panel.
+
+⚙️ Features
+🔐 Login system with admin and student roles
+
+🌈 Theme switching (Playground, Chalkboard, Galaxy, Nature)
+
+📚 Student-specific word list storage (on server!)
+
+📤 Upload word lists or enter manually
+
+🎮 Spelling game with instant feedback and retry mode
+
+🧑‍🏫 Admin tools to manage users and word lists
+
+🐳 Fully containerized via Docker Compose
+
+🐳 Docker Commands
+Run in background:
+
+bash
+docker-compose up -d
+Stop the app:
+
+bash
+docker-compose down
\ No newline at end of file