Mobile App Documentation

Build Together.
Connect. Collaborate. Create.

A comprehensive mobile platform connecting professionals to discover collaborators, manage projects, and engage in community discussions.

50+ API Endpoints
8 Core Modules
25+ Screens
Explore Features View Architecture
Projects +
📁
AI Assistant App
3 members · Active
📁
E-commerce Platform
5 members · Recruiting
📁
Open Source CRM
4 members · Active
🏠 🔍 📁 🔔 👤
Overview

What is Builvero?

Builvero is a professional networking platform designed for collaboration. The mobile app brings the full platform experience to iOS and Android.

🎯

Target Audience

  • Professionals seeking collaborators
  • Project owners building teams
  • Volunteers looking for opportunities
  • Platform administrators
📱

Platforms

  • iOS 13.0+
  • Android API 23+
  • Cross-platform with Flutter
  • Consistent experience
👥

User Roles

  • Regular Users
  • Moderators
  • Administrators
  • Volunteers
Features

Core Modules

8 comprehensive modules covering all aspects of professional collaboration

🔐

Authentication

Email/password login, OAuth providers (Google, GitHub), secure JWT storage, biometric support

POST /auth/login POST /auth/signup GET /auth/oauth/*
👤

Profile Management

View/edit profile, education & experience entries, skills management, S3 photo uploads

GET /profile/me PUT /profile/me POST /profile/photo
🔍

Discovery

Search users and projects, filter by skills and categories, find collaborators

GET /users/search GET /projects/search GET /skills
📁

Projects

Create projects, manage team members, send invitations, handle join requests

GET /projects POST /projects POST /invitations/*
💬

Forums

Project discussions, topic threads, message replies, subscription management

GET /forum/topics POST /forum/messages POST /subscription
🔔

Notifications

Real-time push notifications, in-app notification center, deep linking

GET /notifications POST /notifications/read FCM Integration
🙋

Volunteer

Browse volunteer roles, submit applications with resume upload, track status

GET /volunteer-roles POST /applications S3 Resume Upload
🛡️

Admin Panel

User management, content moderation, application review, broadcast emails

GET /admin/users PATCH /admin/block POST /admin/updates
Technology

Why Flutter?

After comprehensive analysis, Flutter emerged as the optimal choice

✓ Recommended

Flutter

8.95/10
  • ✓ Native performance (Skia/Impeller)
  • ✓ Superior S3 file handling
  • ✓ Excellent offline support (Hive, Drift)
  • ✓ Sound null safety
  • ✓ Pixel-perfect UI consistency
  • ✓ Faster development (~3 weeks saved)

React Native

7.05/10
  • ○ JS bridge can bottleneck
  • ○ File handling more complex
  • ○ Variable package quality
  • ○ TypeScript optional
  • ○ Platform-specific differences
  • ○ Larger talent pool
📦
Riverpod State Management
🧭
go_router Navigation
🌐
Dio HTTP Client
💾
Hive Local Storage
🔥
Firebase Push & Analytics
❄️
Freezed Code Generation
Architecture

Clean Architecture

Feature-based organization with clear separation of concerns

🎨 Presentation Layer
Screens Widgets Providers
↓
⚙️ Domain Layer
Entities Use Cases Repositories
↓
💿 Data Layer
API Services Local Storage DTOs
↓
🔧 Core Layer
DI Theme Utils Router

📁 Project Structure

lib/
├── core/
│   ├── di/           # Dependency injection
│   ├── network/      # API client, interceptors
│   ├── router/       # Navigation
│   └── theme/        # Colors, typography
│
├── features/
│   ├── auth/
│   │   ├── data/         # DTOs, API calls
│   │   ├── domain/       # Entities, use cases
│   │   └── presentation/ # Screens, providers
│   ├── profile/
│   ├── projects/
│   ├── forum/
│   └── admin/
│
└── shared/
    └── widgets/      # Reusable components
UI/UX

App Screens

25+ carefully designed screens with consistent design language

Build Together

Welcome

Entry point with OAuth options

Welcome Back

Login

Email/password authentication

Create Account

Signup

Registration with invitation

Home

Home

Dashboard & activity

Discover

Discover

Search users & projects

Profile

Profile

User profile & skills

Projects

Projects List

My projects overview

Project Detail

Project Detail

Team, description, forum

New Project

Create Project

Start new project

Forum

Topics List

Project discussions

Topic

Topic Detail

Messages & replies

Admin

Admin Dashboard

Quick stats & actions

Users

User Management

Search, block, promote

Applications

Applications

Review volunteers

Backend

API Overview

RESTful JSON API with JWT authentication

🔓 Public Endpoints

POST /api/auth/login
POST /api/auth/signup/email
GET /api/volunteer-roles
POST /api/volunteer-applications

🔒 Protected Endpoints

GET /api/profile/me
GET /api/projects
POST /api/projects/{id}/join
GET /api/notifications

🛡️ Admin Endpoints

GET /api/admin/users
PATCH /api/admin/users/{id}/block
DELETE /api/admin/applications/{id}
POST /api/admin/updates/send
Timeline

Development Roadmap

Estimated 12.5 weeks to MVP

1

Week 1-2: Foundation

  • Project setup & architecture
  • Core layer (DI, networking, theme)
  • Authentication module
2

Week 3-4: Profile & Discovery

  • Profile management
  • S3 photo uploads
  • User/project search
3

Week 5-7: Projects & Forums

  • Project CRUD
  • Invitations & join requests
  • Forum topics & messages
4

Week 8-10: Notifications & Admin

  • Push notifications (FCM)
  • Notification center
  • Admin panel
5

Week 11-12.5: Polish & Launch

  • Volunteer module
  • Testing & bug fixes
  • App store submission
1,000
Target MAU
3 months post-launch
99.5%
Crash-Free Rate
Target reliability
4.0+
App Store Rating
Target rating
<3s
Cold Start
Performance target
Resources

Documentation

Complete project documentation

📋

API Feature List

Complete list of 50+ API endpoints organized by module

View Document →
📄

Product Requirements

Detailed PRD with user stories and success metrics

View Document →
⚖️

Framework Analysis

Comprehensive Flutter vs React Native comparison

View Document →
🏗️

Technical Design

Architecture, folder structure, and implementation details

View Document →
🎨

UI/UX Wireframes

Design system and screen layouts for all modules

View Document →