readme
This commit is contained in:
1 parent
7567fb8144
commit
fb4688f652
2 files changed
+45
-64
No files matched your search
-64
@@ -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.
|
||||
@@ -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
|
||||
Reference in new issue
Block a user