feat: ui polish, docs, api hardening, and common pages

localhost-run-note.md

@@ -0,0 +1,71 @@
+# Dewemoji Localhost Run Note
+
+Quick note so we can run Dewemoji locally anytime.
+
+## Option A (recommended): Docker Compose
+
+From project root:
+
+```bash
+docker compose up --build
+```
+
+Open:
+
+- App: `http://127.0.0.1:8000`
+
+Stop:
+
+```bash
+docker compose down
+```
+
+If you also want to remove DB volume:
+
+```bash
+docker compose down -v
+```
+
+## Option B: Native Laravel (without Docker)
+
+From `app/`:
+
+```bash
+cp .env.example .env
+composer install
+npm install
+php artisan key:generate
+php artisan migrate
+```
+
+Run backend:
+
+```bash
+php artisan serve
+```
+
+Run frontend assets (new terminal):
+
+```bash
+npm run dev
+```
+
+Open:
+
+- App: `http://127.0.0.1:8000`
+
+## Important env notes
+
+- `APP_URL=http://127.0.0.1:8000`
+- For local DB simplicity, SQLite is fine.
+- Dataset path should point to bundled file:
+  - `DEWEMOJI_DATA_PATH=/absolute/path/to/dewemoji/app/data/emojis.json`
+  - or leave empty (default uses bundled `app/data/emojis.json`).
+
+## Quick checks
+
+```bash
+curl -s "http://127.0.0.1:8000/v1/health"
+curl -s "http://127.0.0.1:8000/v1/emojis?limit=3"
+```
+