Case Study
Mobile

GoHighLevel Lead Manager

A mobile CRM companion app for GoHighLevel . Users connect a GoHighLevel sub-account through OAuth, then view and manage that sub-account's contacts and register new leads from the phone. Leads created in the app are tagged so they can start GoHighLevel automation workflows.

Flutter
Dart
Material 3 UI
GoHighLevel Lead Manager screen 1
GoHighLevel Lead Manager screen 2
GoHighLevel Lead Manager screen 3
GoHighLevel Lead Manager screen 4
GoHighLevel Lead Manager screen 5

Challenges & solutions

The technical problems our team solved to ship a reliable, unified mobile experience.

GoHighLevel login stalled after email verification because the embedded WebView blocked popup windows, new tabs, and deep links, preventing navigation to the sub-account picker.

Added a JavaScript script that makes window.open and new-tab links load in the same window. The WebView also follows the web fallback of intent:// links, sends the user back to the sub-account picker automatically once logged in, and uses the correct user agent for each platform. A manual "Choose sub-account" button gives users a way out if the flow stalls.

Sub-account selection failed due to a malformed OAuth redirect URI and a missing version ID required for draft authorization URLs.

Registered an exact https callback URL and added version_id to the authorization URL. The WebView now catches the callback before the page loads and takes the authorization code from it, so the app doesn't need a hosted callback page or a custom URL scheme.

API calls failed because refreshed tokens retained outdated scopes, while Settings displayed configured scopes instead of actually granted scopes.

Matched the app's requested scopes with the Marketplace app configuration (locations.readonly, contacts.readonly, contacts.write). The app now saves the scopes GoHighLevel actually grants and shows them in Settings next to the requested ones, which makes scope problems quick to spot. A fresh authorization is required to get a token with the new scopes.

Key features

What users get in the finished, shipped product.

GoHighLevel OAuth 2.0 Integration

  • Overview: Secure sub-account login through GoHighLevel's Marketplace OAuth flow.
  • Features: Users pick a sub-account inside the app, the app catches the authorization code, and the code is exchanged for access and refresh tokens.

Automatic Token Management

  • Overview: Centralized authentication and token renewal system for secure API communication.
  • Features: A centralized Dio interceptor adds Bearer tokens to every request, refreshes expired tokens automatically when a request fails with a 401, and saves GoHighLevel's new refresh token each time.

CRM Dashboard & Lead Metrics

  • Overview: Live dashboard displaying the connected sub-account's CRM activity and performance.
  • Features: Sub-account details, lead metrics (total, new and converted leads), most recent CRM contacts, and pull-to-refresh.

Contact Management

  • Overview: Contact management interface for viewing and managing contacts directly within the connected GoHighLevel sub-account.
  • Features: View all contacts, search by name, email, phone or company, filter by tags, access detailed contact views, and delete contacts directly in GoHighLevel.

Lead Registration & Workflow Triggering

  • Overview: Lead creation system that connects mobile registration with GoHighLevel CRM automation.
  • Features: Create new leads in GoHighLevel from the phone with custom tags. The tags can start GoHighLevel automation workflows such as follow-up SMS and email campaigns.

Multiple Connection Methods

  • Overview: Flexible authentication options supporting different GoHighLevel integration and testing scenarios.
  • Features: OAuth login, Private Integration Token (PIT) login, manual exchange of an authorization code or callback URL, and a demo workspace for testing the UI.

Session & Token Settings

  • Overview: Centralized settings screen for managing the connected GoHighLevel account and authentication session.
  • Features: Connected location, company ID, token previews, requested and granted OAuth scopes, manual token refresh, and logout that clears all stored tokens.

Secure Credential Storage

  • Overview: Secure local credential storage to protect authentication data across supported mobile platforms.
  • Features: Access tokens, refresh tokens and sub-account IDs are stored in iOS Keychain and Android encrypted storage through Flutter Secure Storage.

Error, Empty & Loading States

  • Overview: Consistent feedback system that keeps users informed during data loading, empty results, and API failures.
  • Features: Clear loading screens, empty states, readable API error messages and Retry buttons when data is missing or a request fails.

Tech integrations

Third-party SDKs & libraries

7 core integrations powered

GoHighLevel API

Core system integration

OAuth 2.0

Core system integration

get

Core system integration

dio

HTTP client & interceptors

flutter_secure_storage

Core system integration

webview_flutter

Core system integration

intl

Core system integration

More Case Studies
Related Work

Similar Projects We've Built

TVibe – Live TV & IPTV Player

TVibe – Live TV & IPTV Player

TVibe is a Flutter-based IPTV streaming app that supports M3U and HLS playlists, offering Live TV, EPG, Chromecast, and picture-in-picture playback. It features automatic channel language detection, adaptive video quality, and advanced category and language filters for a seamless viewing experience.

FlutterDart+2
View Case Study

Sky Radar: Interactive Global Weather & Radar Map

Sky Radar is a high-performance, cross-platform weather radar application built with Flutter. It combines live satellite imagery, Doppler radar loops, planetary temperature heatmaps, and 60 FPS animated wind streamlines over an interactive vector map. Designed with a sleek glassmorphic dark interface, the app delivers hyperlocal weather forecasts alongside fluid, worldwide atmospheric visualizations.

FlutterGetX+1
View Case Study
Meow Mimic: an interactive virtual pet game

Meow Mimic: an interactive virtual pet game

Meow Mimic is a Flutter-based virtual pet game where an interactive 2D cat listens and repeats speech in a cute cartoon voice using offline DSP processing. Players can pet, feed, and play with the cat, explore four themed rooms, and customize their decor.

FlutterDart+4
View Case Study
Bumpy Ride: a physics-based hill climb racing game

Bumpy Ride: a physics-based hill climb racing game

Bumpy Ride is an offline 2D hill-climbing racing game built with Flutter, featuring endless procedurally generated terrain and physics-based vehicle controls. Players collect fuel and coins, upgrade vehicles, and unlock new stages with unique terrain and physics in a colourful cartoon-style world.

FlutterDart+1
View Case Study

Have a similar idea? Let's build it together.

From concept to launch, we turn your vision into a world-class product.