1.3 KiB
1.3 KiB
Phase 1 Foundation Notes
Scaffold status
- App path:
app/ - Framework: Laravel 12
- Native package:
nativephp/desktopinstalled - Native scaffolding generated:
app/config/nativephp.phpapp/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:
- App base
APP_NAME,APP_ENV,APP_DEBUG,APP_URL
- API compatibility
API_BASE_PATH=/v1API_RATE_LIMIT_PER_MINUTE
- Licensing
LICENSE_PROVIDERLICENSE_VERIFY_ENDPOINTLICENSE_VERIFY_SECRET
- NativePHP metadata
NATIVEPHP_APP_IDNATIVEPHP_APP_VERSIONNATIVEPHP_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.