Files
dewemoji/phase-1-foundation.md
2026-02-03 21:58:14 +07:00

1.3 KiB

Phase 1 Foundation Notes

Scaffold status

  • App path: app/
  • Framework: Laravel 12
  • Native package: nativephp/desktop installed
  • Native scaffolding generated:
    • app/config/nativephp.php
    • app/app/Providers/NativeAppServiceProvider.php

Local run commands

From app/:

  • Web/Laravel dev:
    • composer run dev
  • Native desktop dev:
    • composer run native:dev

Environment strategy (initial)

Use app/.env for local only, and keep production secrets out of git.

Planned env groups:

  1. App base
  • APP_NAME, APP_ENV, APP_DEBUG, APP_URL
  1. API compatibility
  • API_BASE_PATH=/v1
  • API_RATE_LIMIT_PER_MINUTE
  1. Licensing
  • LICENSE_PROVIDER
  • LICENSE_VERIFY_ENDPOINT
  • LICENSE_VERIFY_SECRET
  1. NativePHP metadata
  • NATIVEPHP_APP_ID
  • NATIVEPHP_APP_VERSION
  • NATIVEPHP_APP_AUTHOR

Canonical data source decision

Start migration from:

  • ../dewemoji-api/data/emojis.json

Rationale:

  • Most complete enriched dataset currently available.
  • Already includes fields extension needs (supports_skin_tone, categories, subcategories, etc.).

Known local prerequisite note

  • Current machine Node is v20.19.3; it is enough for current scaffold, but we may upgrade to Node 22 later for stricter parity with newer NativePHP docs.