eServiceApps — Mobile Super App v1.0.0

Feature-modular Flutter super app combining social networking, ride-sharing, travel planning, and delivery services into a single mobile platform. Built with Dart/Flutter using clean architecture, Riverpod state management, GoRouter navigation, and Firebase backend.

Stack: Dart 3 + Flutter 3.x | State: Riverpod | Navigation: GoRouter | Backend: Firebase | License: MIT

Project Structure

eServiceApps/
  lib/
    app/              App widget, theme, router
    core/             Shared utilities, constants, extensions
    features/
      social/         models/ services/ views/ widgets/
      ride/           models/ services/ views/ widgets/
      travel/         models/ services/ views/ widgets/
      delivery/       models/ services/ views/ widgets/
      auth/           models/ services/ views/ widgets/
    shared/           Shared widgets, providers, mixins
  test/               Unit and widget tests
  integration_test/   Integration tests
  firebase/           Security rules, indexes

final socialService = ref.watch(socialServiceProvider);

await socialService.createPost(PostModel(
  content: 'Hello world!',
  mediaUrls: [uploadedUrl],
));

final booking = await rideService.requestRide(
  LatLng(37.78, -122.41), LatLng(37.33, -121.89)
);

MapView

Interactive Google Maps widget showing pickup/destination markers, route polyline, and live driver position. Uses google_maps_flutter with custom markers and info windows.

final order = await deliveryService.placeOrder(
  [OrderItem(name:'Pizza',qty:2,price:12.99)],
  Address(street:'123 Main St',city:'SF')
);

final authService = ref.watch(authServiceProvider);

await authService.signInWithEmail('user@example.com', 'pass123');

final cred = await authService.signInWithGoogle();

final cred = await authService.signInWithApple();

AuthGuard

Route guard that redirects unauthenticated users to the login screen. Integrates with GoRouter's redirect callback.

GoRouter(
  redirect: (context, state) {
    final loggedIn = ref.read(authStateProvider).valueOrNull != null;
    if (!loggedIn) return '/login';
    return null;
  },
  routes: [...]
);

final router = createAppRouter(ref);

app_router.dart Configuration

final appRouter = GoRouter(
  initialLocation: '/social/feed',
  routes: [
    GoRoute(path: '/social/feed', builder: (_, __) => FeedView()),
    GoRoute(path: '/social/profile/:id', builder: (_, s) => ProfileView(id: s.pathParameters['id']!)),
    GoRoute(path: '/ride', builder: (_, __) => RideHomeView()),
    GoRoute(path: '/ride/booking/:id', builder: (_, s) => BookingView(id: s.pathParameters['id']!)),
    GoRoute(path: '/travel', builder: (_, __) => TravelHomeView()),
    GoRoute(path: '/delivery', builder: (_, __) => DeliveryHomeView()),
    GoRoute(path: '/delivery/track/:id', builder: (_, s) => TrackingView(id: s.pathParameters['id']!)),
    GoRoute(path: '/login', builder: (_, __) => LoginView()),
  ],
);

AppTheme

class AppTheme {
  static ThemeData light() => ThemeData(
    useMaterial3: true,
    colorSchemeSeed: const Color(0xFF3B82F6),
    brightness: Brightness.light,
    fontFamily: 'Inter',
  );
  static ThemeData dark() => ThemeData(
    useMaterial3: true,
    colorSchemeSeed: const Color(0xFF3B82F6),
    brightness: Brightness.dark,
    fontFamily: 'Inter',
  );
}

final themeMode = ref.watch(themeProvider);
ref.read(themeProvider.notifier).toggle();

Best Practices for Feature Isolation

// Each feature defines its own providers
// features/social/providers.dart
final socialServiceProvider = Provider<SocialService>((ref) {
  final db = ref.watch(firestoreProvider);
  final auth = ref.watch(firebaseAuthProvider);
  return SocialService(db, auth);
});

final feedProvider = StreamProvider.family<List<PostModel>, String>((ref, userId) {
  return ref.watch(socialServiceProvider).getFeed(userId);
});

// In views - use AsyncValue for loading/error/data states
ref.watch(feedProvider(userId)).when(
  data: (posts) => PostList(posts: posts),
  loading: () => const CircularProgressIndicator(),
  error: (e, st) => ErrorWidget(e),
);

Security Rules

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow read: if request.auth != null;
      allow write: if request.auth.uid == userId;
    }
    match /posts/{postId} {
      allow read: if request.auth != null;
      allow create: if request.auth != null
        && request.resource.data.authorId == request.auth.uid;
      allow delete: if resource.data.authorId == request.auth.uid;
    }
    match /bookings/{bookingId} {
      allow read, write: if request.auth != null
        && (resource.data.riderId == request.auth.uid
        || resource.data.driverId == request.auth.uid);
    }
    match /orders/{orderId} {
      allow read, write: if request.auth != null
        && resource.data.userId == request.auth.uid;
    }
  }
}

Data Model