🚀 WFlow - Freelance & Job Management Platform

Flutter Dart Firebase Android iOS

Version License Build Status

A comprehensive freelance and job management platform connecting businesses with skilled workers

📋 Table of Contents

✨ Features

🏢 For Businesses

👷 For Workers

🌟 General Features

📱 Screenshots

🏗️ Architecture

lib/
├── 🎯 core/ # Core utilities and shared components
├── 📊 common/ # Common services (DI, localization, etc.)
├── ⚙️ configuration/ # App configuration and constants
├── 🧩 modules/ # Feature modules
│ ├── 🔐 auth/ # Authentication module
│ ├── 📖 introduction/ # Onboarding module
│ └── 🏠 main/ # Main app features
│ ├── 📡 data/ # Data layer (repositories, models)
│ ├── 🎯 domain/ # Business logic (entities, use cases)
│ └── 🎨 presentation/ # UI layer (screens, widgets, BLoC)

🛠️ Tech Stack

Frontend

Backend Integration

Key Packages

dependencies:
 flutter_bloc: ^8.1.3 # State management
 get_it: ^7.6.4 # Dependency injection
 cached_network_image: ^3.3.0 # Image caching
 file_picker: ^6.1.1 # File selection
 flutter_screenutil: ^5.9.0 # Responsive design
 voice_message_package: ^2.1.3 # Voice messaging
 stringee_flutter_plugin: ^0.8.8 # Video calls

🚀 Getting Started

Prerequisites

Installation

Build Commands

# Android APK
make build-apk
# Android Bundle
make build-appbundle
# iOS
make build-ios

📁 Project Structure

wflow/
├── 📱 android/ # Android-specific code
├── 🍎 ios/ # iOS-specific code
├── 🐧 linux/ # Linux desktop support
├── 🪟 windows/ # Windows desktop support
├── 🖥️ macos/ # macOS desktop support
├── 📦 assets/ # Static assets
│ ├── 🎨 icons/ # App icons
│ ├── 🌍 languages/ # Localization files
│ └── 🎬 anim/ # Lottie animations
├── ⚙️ configs/ # Configuration files
├── 📜 scripts/ # Build and deployment scripts
└── 📚 lib/ # Main application code

🔑 Key Components

🏠 Main Features

Job Management

Messaging System

Identity Verification

🔧 Core Services

Dependency Injection

// lib/common/injection.dart
final GetIt instance = GetIt.instance;

Localization

// lib/common/localization.dart
AppLocalization localization = instance.get<AppLocalization>();
String text = localization.translate('key');

🌐 API Integration

HTTP Client Configuration

// Base URL configuration
const String baseUrl = 'https://api.wflow.com';
// Request/Response models
class UpgradeBusinessRequest {
 final String email;
 final String phone;
 final String name;
 // ... other fields
}

File Upload

// File upload for business logos, CVs, etc.
final response = await fileUseCase.uploadFile(
 request: UploadFileRequest(
 folder: 'Business',
 file: selectedFile,
 ),
);

🎯 State Management

BLoC Pattern Implementation

// Example: Job posting BLoC
class UpPostBloc extends Bloc<UpPostEvent, UpPostState> {
 final PostUseCase postUseCase;
 UpPostBloc({required this.postUseCase}) : super(UpPostState()) {
 on<UpPostAddTaskEvent>(_addTask);
 on<UpPostSubmitEvent>(_submitPost);
 }
 Future<void> _addTask(UpPostAddTaskEvent event, Emitter emit) async {
 // Task addition logic
 }
}

State Classes

class UpPostState {
 final List<String> tasks;
 final bool isLoading;
 final String? error;
 const UpPostState({
 this.tasks = const [],
 this.isLoading = false,
 this.error,
 });
}

🔒 Security Features

🌍 Internationalization

Supported Languages

Usage

Text(instance.get<AppLocalization>().translate('welcome') ?? 'Welcome')

🧪 Testing

# Run unit tests
flutter test
# Run integration tests
flutter test integration_test/
# Generate coverage report
flutter test --coverage

📱 Platform Support

🤝 Contributing

Development Workflow

📄 License

📞 Support

Made with ❤️ by the WFlow Team

GitHub stars GitHub forks