dewemoji/localhost-run-note.md

Dewemoji Localhost Run Note

Quick note so we can run Dewemoji locally anytime.

Option A (recommended): Docker Compose

From project root:

docker compose up --build

Open:

• App: http://127.0.0.1:8000

Stop:

docker compose down

If you also want to remove DB volume:

docker compose down -v

Option B: Native Laravel (without Docker)

From app/:

cp .env.example .env
composer install
npm install
php artisan key:generate
php artisan migrate

Run backend:

php artisan serve

Run frontend assets (new terminal):

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

curl -s "http://127.0.0.1:8000/v1/health"
curl -s "http://127.0.0.1:8000/v1/emojis?limit=3"