name: maths-habit-project description: "Project location and build context for The Maths Habit app. Use this skill whenever working on The Maths Habit codebase — building, debugging, updating, syncing Capacitor, generating AAB/IPA builds, or any development task. Also use when Claude needs to find or access the source code, or when the user says 'update the app', 'build the app', 'sync android', 'generate AAB', 'open the project', or references The Maths Habit source files. If the project folder isn't already mounted, this skill tells you where to find it."
The Maths Habit — Project Location & Build Context
Source code location
The Maths Habit source code lives in the user's home folder:
~/The-Maths-Habit
Full path: /Users/karrahartland/The-Maths-Habit
If this folder isn't already mounted in the session, use request_cowork_directory with path ~/The-Maths-Habit to mount it before doing any work.
Tech stack
- Frontend: React + Vite + Tailwind CSS
- Mobile wrapper: Capacitor 8.2.0 (iOS + Android)
- Backend: Supabase (auth, database)
- Payments: Stripe (hidden on iOS per Apple Guideline 3.1.1)
- Error tracking: Sentry
- Deployment (web): Vercel at www.themathshabit.co.uk
Android AAB build process
npm run build— build the web assetsnpx cap sync android— sync web build into the Android project- Bump
versionCodeandversionNameinandroid/app/build.gradle cd android && ./gradlew bundleRelease— generate the signed AAB- Output:
android/app/build/outputs/bundle/release/app-release.aab
Signing requires the release keystore (themathshabit-upload.keystore) and credentials in android/gradle.properties.
iOS build process
iOS builds are done through Xcode. After npx cap sync ios, open the Xcode project and archive from there.
Key config files
capacitor.config.ts— app ID:com.squareonemaths.appandroid/app/build.gradle— Android version, SDK levels, signing configpackage.json— dependencies and web build scriptsios/App/App.xcodeproj— Xcode project
Important notes
- Karra prefers using GitHub Desktop for git operations, not the terminal
- The web version deploys automatically via Vercel when changes are pushed to GitHub
- Android and iOS builds need to be done manually after web changes — they don't auto-deploy