Developer Guide - utourismboard/explore-uganda-application-documentation GitHub Wiki

Developer Guide

Table of Contents

  1. Introduction
  2. Quick Start
  3. Prerequisites
  4. Development Resources
  5. Contributing Guidelines
  6. Support

Introduction

Welcome to the Explore Uganda App developer documentation. This guide provides comprehensive information for developers working on the project. Whether you're setting up your development environment, understanding the project structure, or preparing for deployment, you'll find detailed instructions here.

Quick Start

# Clone the repository
git clone https://github.com/explore-uganda/mobile-app.git

# Install dependencies
flutter pub get

# Run the app
flutter run

Prerequisites

  • Flutter SDK v3.19.0
  • Dart v3.3.0
  • Android Studio / VS Code
  • Git
  • Firebase CLI
  • Node.js (for backend services)

Development Resources

Contributing Guidelines

Code Style

  • Follow the official Dart Style Guide
  • Use meaningful variable and function names
  • Write comments for complex logic
  • Include documentation for public APIs

Git Workflow

graph LR
    A[Feature Branch] --> B[Development]
    B --> C[Staging]
    C --> D[Main]
  1. Create feature branch from development
  2. Make changes and commit
  3. Create pull request
  4. Code review
  5. Merge to development

Commit Messages

  • Use present tense ("Add feature" not "Added feature")
  • Be descriptive but concise
  • Reference issue numbers when applicable

Example:

feat: add hotel booking functionality (#123)
fix: resolve crash in payment flow
docs: update API documentation

Pull Request Process

  1. Update documentation if needed
  2. Add/update tests
  3. Ensure CI/CD passes
  4. Get code review approval
  5. Squash and merge

Support

  • Technical Support: [email protected]
  • Developer Chat: [Slack Channel]
  • Issue Tracker: GitHub Issues
  • Documentation Updates: Submit PR to documentation repository