Mobile App for the Yoruba Organization Think Yoruba First aka TYF
# Think Yoruba First — Flutter App
A premium, directory-style mobile application for the **Think Yoruba First** movement.
## Tech Stack
| Layer | Technology |
|---|---|
| Framework | Flutter 3.x (Dart 3.3+) |
| Fonts | Google Fonts (Inter) |
| External Links | url_launcher ^6.2.5 |
| Image Loading | cached_network_image ^3.3.1 |
| State | StatefulWidget + setState (lightweight, no extra packages needed) |
---
## Project Structure
```
lib/
├── main.dart ← App entry, MaterialApp, BottomNavigationBar
├── theme/
│ └── tyf_theme.dart ← All colors, text styles, ThemeData
├── services/
│ └── link_service.dart ← All external URL / deep-link logic
├── widgets/
│ └── tyf_button.dart ← PressableScale, TYFButton, GoldBorderCard…
├── views/ ← Top-level tab screens (live in IndexedStack)
│ ├── home_view.dart
│ ├── tyf_pac_view.dart
│ ├── notice_board_view.dart
│ ├── community_view.dart
│ └── more_view.dart
└── screens/ ← Pushed via Navigator.push
├── donation_screen.dart
└── library_screen.dart
```
---
## Quick Start
### 1. Prerequisites
- Flutter SDK **≥ 3.3.0** — Install Flutter
- Dart SDK **≥ 3.3.0** (bundled with Flutter)
- VS Code with the **Flutter** and **Dart** extensions, OR Android Studio
### 2. Clone / Open the Project
```bash
# If you downloaded the zip, unzip it first, then:
cd think_yoruba_first
```
### 3. Install Dependencies
```bash
flutter pub get
```
### 4. Run the App
```bash
# Connected Android device or emulator:
flutter run
# iOS Simulator (macOS only):
flutter run -d ios
# Chrome (web preview):
flutter run -d chrome
```
### 5. Build a Release APK (Android)
```bash
flutter build apk --release
# Output: build/app/outputs/flutter-apk/app-release.apk
```
---
## Customisation Checklist
| Item | Where to Edit |
|---|---|
| Brand colors | `lib/theme/tyf_theme.dart` → `TYFColors` |
| Social media handles | `lib/services/link_service.dart` → `TYFLi …