iamdoubz
6e4bc2b86b
MB3 (PBX spec 13 §5). Expo SDK 58 + Expo Router, with the PBX repo as a submodule for @selfphoneng/shared types (import type only). - pair by scanning the QR from My settings → Mobile app, by typing the server and code, or from a selfphoneng://pair link (waits for a tap) - the device token lives in expo-secure-store; a 401 goes back to pairing - home shows who and which extension the phone is paired as; Sign out removes the phone on the server too - README: Android APK build (and the Windows long-path fix), iPhone builds with ios-builder
30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# AGENTS.md — Rules for AI coding agents working on the SelfPhoneNG mobile app
|
||
|
||
The spec lives in the PBX repo: read `vendor/selfphoneng/AGENTS.md`, then
|
||
`vendor/selfphoneng/docs/spec/13-mobile.md` (this app), and `04-backend-api.md` for the API.
|
||
Tasks are MB3–MB8 in 13 §5: one at a time, as the PBX's hard rules say.
|
||
|
||
## Expo changes fast: don't trust memory
|
||
|
||
Read the `expo` major in `package.json`, then the matching docs
|
||
(`https://docs.expo.dev/versions/v<major>.0.0/`, or Context7). Add packages with
|
||
`npx expo install <package>` (SDK-compatible versions), never `npm install` for Expo or React
|
||
Native packages.
|
||
|
||
## Rules
|
||
|
||
- Routes are in `src/app/` (Expo Router); everything else in `src/`.
|
||
- `android/` and `ios/` are generated (`npx expo prebuild`): never edit or commit them. Native
|
||
settings go in `app.json` and config plugins.
|
||
- API types come from `@selfphoneng/shared` (the submodule) with `import type` only, so Metro never
|
||
bundles the PBX's code. Don't redefine a type the PBX already exports.
|
||
- Every source file starts with `// SPDX-License-Identifier: AGPL-3.0-or-later`.
|
||
- Open source only (PBX hard rule 4). New dependencies are listed in 13 §1 with the reason.
|
||
- Never log the device token, SIP password or voicemail audio.
|
||
|
||
## Before saying a task is done
|
||
|
||
```bash
|
||
npm run typecheck && npm run lint && npx expo export --platform android --platform ios
|
||
```
|