# 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`

2. API compatibility
- `API_BASE_PATH=/v1`
- `API_RATE_LIMIT_PER_MINUTE`

3. Licensing
- `LICENSE_PROVIDER`
- `LICENSE_VERIFY_ENDPOINT`
- `LICENSE_VERIFY_SECRET`

4. 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.
