Kita memasuki Fase 6: PROJECT — rangkaian proyek nyata yang menggabungkan semua skill dari Fase 1-5. Project pertama: E-Commerce App (4 part).
Di part 1 ini, kita akan:
- Setup struktur project modular (Clean Architecture + Repository Pattern)
- Konfigurasi dependencies utama (get_it, dio, bloc, hive, dll)
- Siapkan Theme, Routing, dan Core Module
- Buat model data dasar (Product, Category, Cart)
1. Inisialisasi Project
flutter create ecommerce_app --org com.ahsai --project-name ecommerce_app
cd ecommerce_app
Buka pubspec.yaml dan tambahkan dependencies:
dependencies:
flutter:
sdk: flutter
cupertino_icons: ^1.0.8
# State Management
flutter_bloc: ^8.1.6
# Dependency Injection
get_it: ^7.7.0
injectable: ^2.4.2
# Network
dio: ^5.5.0+1
connectivity_plus: ^6.0.3
# Local Storage
hive: ^2.2.3
hive_flutter: ^1.1.0
shared_preferences: ^2.2.3
# Utils
equatable: ^2.0.5
intl: ^0.19.0
cached_network_image: ^3.3.1
# Routing
go_router: ^14.2.0
dev_dependencies:
flutter_test:
sdk: flutter
flutter_lints: ^4.0.0
build_runner: ^2.4.11
injectable_generator: ^2.6.1
hive_generator: ^2.0.1
Jalankan flutter pub get lalu generate code:
flutter pub run build_runner build --delete-conflicting-outputs
2. Struktur Folder (Clean Architecture)
lib/
├── core/
│ ├── constants/
│ │ ├── app_constants.dart
│ │ └── api_endpoints.dart
│ ├── di/
│ │ └── injection.dart
│ ├── error/
│ │ ├── exceptions.dart
│ │ └── failures.dart
│ ├── network/
│ │ ├── api_client.dart
│ │ └── network_info.dart
│ ├── router/
│ │ └── app_router.dart
│ ├── theme/
│ │ ├── app_theme.dart
│ │ └── app_colors.dart
│ └── utils/
│ ├── formatters.dart
│ └── validators.dart
├── features/
│ ├── auth/
│ ├── cart/
│ ├── category/
│ ├── home/
│ ├── product/
│ ├── profile/
│ └── checkout/
├── shared/
│ ├── widgets/
│ │ ├── buttons/
│ │ ├── inputs/
│ │ └── loaders/
│ └── models/
│ ├── product.dart
│ ├── category.dart
│ └── cart_item.dart
└── main.dart
3. Core Module Implementation
3.1 Constants & API Endpoints
// lib/core/constants/app_constants.dart
class AppConstants {
static const String appName = 'AhsaiShop';
static const String baseUrl = 'https://api.ahsai.my.id/v1';
static const Duration apiTimeout = Duration(seconds: 30);
static const int productsPerPage = 20;
}
// lib/core/constants/api_endpoints.dart
class ApiEndpoints {
static const String products = '/products';
static const String categories = '/categories';
static const String auth = '/auth';
static const String cart = '/cart';
static const String orders = '/orders';
static const String users = '/users';
}
3.2 Error Handling (Failures & Exceptions)
// lib/core/error/exceptions.dart
class ServerException implements Exception {
final String message;
final int? statusCode;
const ServerException(this.message, {this.statusCode});
@override String toString() => 'ServerException: $message';
}
class CacheException implements Exception {
final String message;
const CacheException(this.message);
@override String toString() => 'CacheException: $message';
}
class NetworkException implements Exception {
final String message;
const NetworkException(this.message);
@override String toString() => 'NetworkException: $message';
}
// lib/core/error/failures.dart
import 'package:equatable/equatable.dart';
abstract class Failure extends Equatable {
final String message;
const Failure(this.message);
@override List<Object?> get props => [message];
}
class ServerFailure extends Failure {
const ServerFailure(super.message);
}
class CacheFailure extends Failure {
const CacheFailure(super.message);
}
class NetworkFailure extends Failure {
const NetworkFailure(super.message);
}
class ValidationFailure extends Failure {
final Map<String, String> errors;
const ValidationFailure(this.errors) : super('Validation failed');
@override List<Object?> get props => [message, errors];
}
3.3 Network Layer (Dio Client)
// lib/core/network/api_client.dart
import 'package:dio/dio.dart';
import 'package:injectable/injectable.dart';
import '../constants/app_constants.dart';
import '../constants/api_endpoints.dart';
import '../error/exceptions.dart';
@LazySingleton()
class ApiClient {
final Dio _dio;
ApiClient() : _dio = Dio(BaseOptions(
baseUrl: AppConstants.baseUrl,
connectTimeout: AppConstants.apiTimeout,
receiveTimeout: AppConstants.apiTimeout,
headers: {'Content-Type': 'application/json'},
)) {
_dio.interceptors.add(LogInterceptor(
requestBody: true,
responseBody: true,
logPrint: (obj) => print('[DIO] $obj'),
));
_dio.interceptors.add(InterceptorsWrapper(
onError: (error, handler) {
if (error.type == DioExceptionType.connectionTimeout ||
error.type == DioExceptionType.receiveTimeout) {
return handler.reject(NetworkException('Koneksi timeout'));
}
if (error.response?.statusCode != null) {
return handler.reject(ServerException(
error.response?.data['message'] ?? 'Server error',
statusCode: error.response?.statusCode,
));
}
return handler.next(error);
},
));
}
Dio get dio => _dio;
// Helper methods
Future<Response> get(String path, {Map<String, dynamic>? query}) =>
_dio.get(path, queryParameters: query);
Future<Response> post(String path, {dynamic data}) =>
_dio.post(path, data: data);
Future<Response> put(String path, {dynamic data}) =>
_dio.put(path, data: data);
Future<Response> delete(String path) => _dio.delete(path);
}
// lib/core/network/network_info.dart
import 'package:connectivity_plus/connectivity_plus.dart';
import 'package:injectable/injectable.dart';
@LazySingleton()
class NetworkInfo {
final Connectivity _connectivity;
NetworkInfo(this._connectivity);
Future<bool> get isConnected async {
final result = await _connectivity.checkConnectivity();
return result != ConnectivityResult.none;
}
}
3.4 Dependency Injection Setup
// lib/core/di/injection.dart
import 'package:get_it/get_it.dart';
import 'package:injectable/injectable.dart';
import 'injection.config.dart';
final getIt = GetIt.instance;
@InjectableInit(
initializerName: 'init',
preferRelativeImports: true,
asExtension: false,
)
Future<void> configureDependencies() async {
await getIt.init();
}
// lib/core/di/injection.config.dart (auto-generated)
// Jangan edit manual - di-generate oleh build_runner
3.5 Theme & Colors
// lib/core/theme/app_colors.dart
import 'package:flutter/material.dart';
class AppColors {
// Primary
static const Color primary = Color(0xFF6366F1); // Indigo
static const Color primaryLight = Color(0xFF818CF8);
static const Color primaryDark = Color(0xFF4F46E5);
// Secondary
static const Color secondary = Color(0xFFEC4899); // Pink
static const Color secondaryLight = Color(0xFFF472B6);
// Neutral
static const Color background = Color(0xFFFAFAFA);
static const Color surface = Color(0xFFFFFFFF);
static const Color textPrimary = Color(0xFF111827);
static const Color textSecondary = Color(0xFF6B7280);
static const Color divider = Color(0xFFE5E7EB);
// Status
static const Color success = Color(0xFF10B981);
static const Color warning = Color(0xFFF59E0B);
static const Color error = Color(0xFFEF4444);
// Gradients
static const LinearGradient primaryGradient = LinearGradient(
colors: [primary, primaryDark],
begin: Alignment.topLeft,
end: Alignment.bottomRight,
);
}
// lib/core/theme/app_theme.dart
import 'package:flutter/material.dart';
import 'app_colors.dart';
class AppTheme {
static ThemeData get lightTheme => ThemeData(
useMaterial3: true,
colorScheme: ColorScheme.fromSeed(
seedColor: AppColors.primary,
brightness: Brightness.light,
),
scaffoldBackgroundColor: AppColors.background,
appBarTheme: const AppBarTheme(
elevation: 0,
centerTitle: true,
backgroundColor: AppColors.surface,
foregroundColor: AppColors.textPrimary,
titleTextStyle: TextStyle(
fontSize: 20,
fontWeight: FontWeight.w600,
color: AppColors.textPrimary,
),
),
cardTheme: CardThemeData(
elevation: 0,
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(16),
side: const BorderSide(color: AppColors.divider),
),
color: AppColors.surface,
),
elevatedButtonTheme: ElevatedButtonThemeData(
style: ElevatedButton.styleFrom(
backgroundColor: AppColors.primary,
foregroundColor: Colors.white,
elevation: 0,
padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 14),
shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
textStyle: const TextStyle(fontSize: 16, fontWeight: FontWeight.w600),
),
),
inputDecorationTheme: InputDecorationTheme(
filled: true,
fillColor: AppColors.surface,
contentPadding: const EdgeInsets.symmetric(horizontal: 16, vertical: 16),
border: OutlineInputBorder(
borderRadius: BorderRadius.circular(12),
borderSide: const BorderSide(color: AppColors.divider),
),
enabledBorder: OutlineInputBorder(
borderRadius: BorderRadius.circular(12),
borderSide: const BorderSide(color: AppColors.divider),
),
focusedBorder: OutlineInputBorder(
borderRadius: BorderRadius.circular(12),
borderSide: const BorderSide(color: AppColors.primary, width: 2),
),
errorBorder: OutlineInputBorder(
borderRadius: BorderRadius.circular(12),
borderSide: const BorderSide(color: AppColors.error),
),
labelStyle: const TextStyle(color: AppColors.textSecondary),
hintStyle: const TextStyle(color: AppColors.textSecondary),
),
textTheme: const TextTheme(
headlineLarge: TextStyle(fontSize: 32, fontWeight: FontWeight.bold, color: AppColors.textPrimary),
headlineMedium: TextStyle(fontSize: 28, fontWeight: FontWeight.bold, color: AppColors.textPrimary),
titleLarge: TextStyle(fontSize: 22, fontWeight: FontWeight.w600, color: AppColors.textPrimary),
titleMedium: TextStyle(fontSize: 18, fontWeight: FontWeight.w600, color: AppColors.textPrimary),
bodyLarge: TextStyle(fontSize: 16, color: AppColors.textPrimary),
bodyMedium: TextStyle(fontSize: 14, color: AppColors.textSecondary),
labelLarge: TextStyle(fontSize: 14, fontWeight: FontWeight.w600, color: AppColors.textPrimary),
),
);
}
3.6 Routing (GoRouter)
// lib/core/router/app_router.dart
import 'package:go_router/go_router.dart';
import 'package:injectable/injectable.dart';
@LazySingleton()
class AppRouter {
final GoRouter router;
AppRouter() : router = GoRouter(
initialLocation: '/',
routes: [
GoRoute(
path: '/',
name: 'home',
builder: (context, state) => const HomePage(),
routes: [
GoRoute(
path: 'product/:id',
name: 'product-detail',
builder: (context, state) => ProductDetailPage(
productId: state.pathParameters['id']!,
),
),
GoRoute(
path: 'category/:id',
name: 'category-products',
builder: (context, state) => CategoryProductsPage(
categoryId: state.pathParameters['id']!,
),
),
],
),
GoRoute(
path: '/cart',
name: 'cart',
builder: (context, state) => const CartPage(),
),
GoRoute(
path: '/profile',
name: 'profile',
builder: (context, state) => const ProfilePage(),
),
GoRoute(
path: '/checkout',
name: 'checkout',
builder: (context, state) => const CheckoutPage(),
),
GoRoute(
path: '/login',
name: 'login',
builder: (context, state) => const LoginPage(),
),
GoRoute(
path: '/register',
name: 'register',
builder: (context, state) => const RegisterPage(),
),
],
);
}
4. Shared Models (Hive Ready)
// lib/shared/models/product.dart
import 'package:hive/hive.dart';
import 'package:equatable/equatable.dart';
part 'product.g.dart';
@HiveType(typeId: 0)
class Product extends Equatable {
@HiveField(0)
final String id;
@HiveField(1)
final String name;
@HiveField(2)
final String description;
@HiveField(3)
final double price;
@HiveField(4)
final double? discountPrice;
@HiveField(5)
final String imageUrl;
@HiveField(6)
final List<String> galleryImages;
@HiveField(7)
final String categoryId;
@HiveField(8)
final String categoryName;
@HiveField(9)
final int stock;
@HiveField(10)
final double rating;
@HiveField(11)
final int reviewCount;
@HiveField(12)
final bool isFeatured;
@HiveField(13)
final DateTime createdAt;
const Product({
required this.id,
required this.name,
required this.description,
required this.price,
this.discountPrice,
required this.imageUrl,
required this.galleryImages,
required this.categoryId,
required this.categoryName,
required this.stock,
required this.rating,
required this.reviewCount,
required this.isFeatured,
required this.createdAt,
});
double get effectivePrice => discountPrice ?? price;
bool get hasDiscount => discountPrice != null && discountPrice! < price;
int get discountPercentage => hasDiscount
? ((1 - effectivePrice / price) * 100).round()
: 0;
factory Product.fromJson(Map<String, dynamic> json) => Product(
id: json['id'] as String,
name: json['name'] as String,
description: json['description'] as String,
price: (json['price'] as num).toDouble(),
discountPrice: json['discount_price'] != null
? (json['discount_price'] as num).toDouble()
: null,
imageUrl: json['image_url'] as String,
galleryImages: List<String>.from(json['gallery_images'] ?? []),
categoryId: json['category_id'] as String,
categoryName: json['category_name'] as String,
stock: json['stock'] as int,
rating: (json['rating'] as num?)?.toDouble() ?? 0.0,
reviewCount: json['review_count'] as int? ?? 0,
isFeatured: json['is_featured'] as bool? ?? false,
createdAt: DateTime.parse(json['created_at'] as String),
);
Map<String, dynamic> toJson() => {
'id': id,
'name': name,
'description': description,
'price': price,
'discount_price': discountPrice,
'image_url': imageUrl,
'gallery_images': galleryImages,
'category_id': categoryId,
'category_name': categoryName,
'stock': stock,
'rating': rating,
'review_count': reviewCount,
'is_featured': isFeatured,
'created_at': createdAt.toIso8601String(),
};
@override
List<Object?> get props => [
id, name, description, price, discountPrice, imageUrl,
galleryImages, categoryId, categoryName, stock, rating,
reviewCount, isFeatured, createdAt,
];
}
// lib/shared/models/category.dart
import 'package:hive/hive.dart';
import 'package:equatable/equatable.dart';
part 'category.g.dart';
@HiveType(typeId: 1)
class Category extends Equatable {
@HiveField(0)
final String id;
@HiveField(1)
final String name;
@HiveField(2)
final String? imageUrl;
@HiveField(3)
final int productCount;
@HiveField(4)
final int sortOrder;
const Category({
required this.id,
required this.name,
this.imageUrl,
required this.productCount,
required this.sortOrder,
});
factory Category.fromJson(Map<String, dynamic> json) => Category(
id: json['id'] as String,
name: json['name'] as String,
imageUrl: json['image_url'] as String?,
productCount: json['product_count'] as int? ?? 0,
sortOrder: json['sort_order'] as int? ?? 0,
);
Map<String, dynamic> toJson() => {
'id': id,
'name': name,
'image_url': imageUrl,
'product_count': productCount,
'sort_order': sortOrder,
};
@override
List<Object?> get props => [id, name, imageUrl, productCount, sortOrder];
}
// lib/shared/models/cart_item.dart
import 'package:hive/hive.dart';
import 'package:equatable/equatable.dart';
import 'product.dart';
part 'cart_item.g.dart';
@HiveType(typeId: 2)
class CartItem extends Equatable {
@HiveField(0)
final String id;
@HiveField(1)
final Product product;
@HiveField(2)
final int quantity;
@HiveField(3)
final DateTime addedAt;
const CartItem({
required this.id,
required this.product,
required this.quantity,
required this.addedAt,
});
double get subtotal => product.effectivePrice * quantity;
CartItem copyWith({int? quantity}) => CartItem(
id: id,
product: product,
quantity: quantity ?? this.quantity,
addedAt: addedAt,
);
factory CartItem.fromProduct(Product product, {int quantity = 1}) => CartItem(
id: '${product.id}_${DateTime.now().millisecondsSinceEpoch}',
product: product,
quantity: quantity,
addedAt: DateTime.now(),
);
Map<String, dynamic> toJson() => {
'id': id,
'product_id': product.id,
'quantity': quantity,
'added_at': addedAt.toIso8601String(),
};
@override
List<Object?> get props => [id, product, quantity, addedAt];
}
5. Main Entry Point
// lib/main.dart
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:hive_flutter/hive_flutter.dart';
import 'package:get_it/get_it.dart';
import 'core/di/injection.dart';
import 'core/router/app_router.dart';
import 'core/theme/app_theme.dart';
import 'shared/models/product.dart';
import 'shared/models/category.dart'
import 'shared/models/cart_item.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
// Initialize Hive
await Hive.initFlutter();
Hive.registerAdapter(ProductAdapter());
Hive.registerAdapter(CategoryAdapter());
Hive.registerAdapter(CartItemAdapter());
await Hive.openBox<Product>('products_cache');
await Hive.openBox<Category>('categories_cache');
await Hive.openBox<CartItem>('cart_box');
// Configure Dependencies
await configureDependencies();
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
final router = getIt<AppRouter>().router;
return MaterialApp.router(
title: 'AhsaiShop',
debugShowCheckedModeBanner: false,
theme: AppTheme.lightTheme,
routerConfig: router,
);
}
}
6. Placeholder Pages (Untuk Routing)
Buat file minimal di lib/features/home/presentation/pages/home_page.dart:
// lib/features/home/presentation/pages/home_page.dart
import 'package:flutter/material.dart';
class HomePage extends StatelessWidget {
const HomePage({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('AhsaiShop')),
body: const Center(child: Text('Home Page - Coming Soon')),
bottomNavigationBar: BottomNavigationBar(
items: const [
BottomNavigationBarItem(icon: Icon(Icons.home), label: 'Home'),
BottomNavigationBarItem(icon: Icon(Icons.category), label: 'Kategori'),
BottomNavigationBarItem(icon: Icon(Icons.shopping_cart), label: 'Keranjang'),
BottomNavigationBarItem(icon: Icon(Icons.person), label: 'Profil'),
],
),
);
}
}
Buat placeholder serupa untuk ProductDetailPage, CategoryProductsPage, CartPage, ProfilePage, CheckoutPage, LoginPage, RegisterPage.
7. Verifikasi Setup
Jalankan project:
flutter run
Seharusnya muncul halaman Home dengan bottom navigation. Semua routing, theme, DI, dan model sudah siap.
Kesimpulan Part 1
Di part 1 ini kita sudah:
- ✅ Setup Clean Architecture structure
- ✅ Konfigurasi dependencies modern (BLoC, GetIt, Dio, Hive, GoRouter)
- ✅ Core module: Constants, Error Handling, Network, DI, Theme, Router
- ✅ Shared Models dengan Hive adapters untuk caching offline
- ✅ Main entry point dengan Hive initialization
Part 2 akan membahas: Repository Pattern, Data Sources, dan BLoC untuk Home/Produk.
Coba sendiri! Share ke sosial media dan tag @ahsai001