A skill-building app where an LLM agent creates personalized learning plans with git-like plan branching.

cd Backend/FastAPI
pip install -r requirements.txt
cp .env.example .env   # fill in your credentials
uvicorn main:app --reload

Health check: GET http://localhost:8000/health

cd Frontend/Flutter
flutter pub get
flutter run --dart-define=FIREBASE_API_KEY=<your-firebase-web-api-key>

By default the app connects to http://127.0.0.1:8000/api. The FIREBASE_API_KEY enables automatic token refresh — without it the app still works but users will need to re-login after 1 hour.

npm install -g @railway/cli
railway login

cd Backend/FastAPI
railway link

Select your project and environment when prompted.

In the Railway dashboard (or via railway variables set), add:

railway up

Or connect your GitHub repo in the Railway dashboard for automatic deploys on push.

curl https://<your-app>.railway.app/health
# → {"status":"ok"}

Note your Railway URL — you'll need it for the APK build.

• Flutter SDK installed
• Android SDK with build-tools
• Java 17+

cd Frontend/Flutter
flutter build apk --release \
  --dart-define=API_URL=https://<your-app>.railway.app/api \
  --dart-define=FIREBASE_API_KEY=<your-firebase-web-api-key>

Replace <your-app>.railway.app with your actual Railway domain and <your-firebase-web-api-key> with your Firebase Web API key (found in the Firebase Console under Project Settings → General). The API key is required for automatic token refresh — without it, users will be logged out after 1 hour when their Firebase ID token expires.

build/app/outputs/flutter-apk/app-release.apk

Share this file directly — users install it by opening the .apk on their Android device (they'll need to allow "Install from unknown sources").

The auth flow:

1. Call /api/auth/login (or /register, /oauth) — get back id_token, refresh_token, and custom_token
2. Token is stored in encrypted secure storage (Android Keystore / iOS Keychain)
3. Authorization: Bearer <id_token> is attached to every subsequent API call
4. When the id_token expires (1 hour), use the refresh_token to get a new one via the Firebase REST API (securetoken.googleapis.com/v1/token?key=<API_KEY>)

See Backend/FastAPI/.env.example for the full list of required variables.