Nodo (Expo + Bun)

Task list app similar to Google Keep: named lists, check/uncheck items, suggestions from already checked items, sorting (alphabetical / last added). Local storage. Hexagonal architecture for reuse of the business core on the web later.

Stack

• Bun – dependency and script management
• Expo – React Native (Android, iOS, web)
• TypeScript

Commands

bun install
bun run start    # Expo dev server
bun run android  # Run on Android
bun run ios      # Run on iOS (macOS)
bun run web      # Run on web

Releases (release-it + GitHub)

Les releases sont gérées par release-it : bump de version (package.json + app.json), tag git, push et création de la release GitHub.

bun run release        # interactif (choix du bump, message, etc.)
bun run release -- minor --ci   # bump minor en mode CI (non interactif)

À chaque publication d’une release GitHub, une GitHub Action :

1. Lance un build Android en local (expo prebuild + Gradle) → APK
2. Attache l’artefact nodo-android.apk à la release (pas de publication Play Store)

Aucun secret requis (build en CI, pas EAS).

Android Build

Option 1: EAS Build (recommended)

Build in the cloud via Expo Application Services. Requires an Expo account (free).

bunx eas-cli login
bunx eas-cli build:configure   # creates eas.json if needed
bunx eas-cli build --platform android

• APK (debug or release): add --profile preview or configure a profile in eas.json with "buildType": "apk".
• AAB (default): for Play Store publication.

Option 2: Local build

Generates the native Android project then builds with Gradle. Prerequisites: Android SDK, ANDROID_HOME environment variable.

bunx expo prebuild --platform android
cd android && ./gradlew assembleRelease

The APK is in android/app/build/outputs/apk/release/. For AAB (Play Store): ./gradlew bundleRelease → android/app/build/outputs/bundle/release/.

Structure (hexagonal)

• src/domain – Entities (Checklist, ChecklistItem), no dependencies
• src/application – Ports (storage) and use cases (list, get, save, create, toggle, add/remove item)
• src/infrastructure – Storage adapter (AsyncStorage)
• src/presentation – Theme (overridable), context, screens and React Native components

Domain and application are plain TypeScript, reusable by a future web app.

Theme

Default Material/Android-style theme. To override: wrap the app with <ThemeProvider initialTheme={customTheme}> or use useTheme().setTheme(...).