🚀 Forja Labs Posts

A modern, multi-platform posts application built with cutting-edge technologies

🌐 Web • 📱 iOS • 🤖 Android • ⚡ Backend

---

🏗️ Architecture Overview

This project demonstrates modern software architecture patterns across multiple platforms, showcasing best practices and clean code principles:

┌─────────────────┬─────────────────┬─────────────────┬─────────────────┐
│      Web        │       iOS       │    Android      │    Backend      │
│   (React.js)    │   (SwiftUI)     │   (Kotlin)      │     (Go)        │
├─────────────────┼─────────────────┼─────────────────┼─────────────────┤
│ • Components    │ • VIP Pattern   │ • MVVM/Clean    │ • Clean Arch    │
│ • React Hooks   │ • SwiftUI       │ • Jetpack       │ • Gin Framework │
│ • State Mgmt    │ • Combine       │ • Coroutines    │ • GORM          │
│ • TypeScript    │ • iOS 18.5+     │ • Material 3    │ • PostgreSQL    │
└─────────────────┴─────────────────┴─────────────────┴─────────────────┘

---

🛠️ Technology Stack

🌐 Web Frontend React.js + TypeScript ⚛️ React 18+ with Hooks 🎨 Modern CSS/Styled Components 🔄 State Management (Redux/Zustand) 📱 Responsive Design

📱 iOS App SwiftUI + VIP Architecture 🍎 Swift 5.0+ & SwiftUI 🏗️ VIP (View-Interactor-Presenter) 🔄 Combine Framework 🎯 iOS 18.5+ / macOS 15.5+ ⚡ Modern iOS Development

🤖 Android App Kotlin + Modern Android 🎯 Kotlin Multiplatform 🏗️ Clean Architecture + MVVM 🔄 Coroutines & Flow 🎨 Jetpack Compose 📱 Material Design 3

⚡ Backend API Go + PostgreSQL 🚀 Go 1.24.6 🗄️ PostgreSQL Database 📊 GORM ORM 🐳 Docker & Docker Compose 🔄 Hot Reload (Air)

---

👥 Development Teams

🌐 Web Team - React.js Frontend

👨‍💻 Team Members

Gabriel Andrade Front-End Developer

Rebeca Maciel Front-End Developer

Joab Ribeiro Student

Leonardo Silva FullStack Developer

Mauro Freelancer Developer

🎯 Responsibilities

• React.js application development
• User interface design and implementation
• State management and performance optimization
• Cross-browser compatibility
• Progressive Web App (PWA) features

📱 iOS Team - SwiftUI Development

👨‍💻 Team Members

Vinicius Rossado Senior Software Engineer

Walisson Teodoro React Front-End Developer

Willians Varela Back-end Developer

Maki Student

🎯 Responsibilities

• SwiftUI application architecture (VIP pattern)
• iOS/macOS native features integration
• App Store optimization and submission
• Performance profiling and optimization
• iOS-specific UI/UX patterns

🤖 Android Team - Kotlin Development

👨‍💻 Team Members

Jonatas Silva Software Engineer Mid Level

Hemilio Araujo Backend Developer

Paloma Cristina Student

Mauro Freelancer Developer

Paulo Estevão Front-End Developer

🎯 Responsibilities

• Kotlin application development
• Android architecture components
• Google Play Store optimization
• Material Design implementation
• Android-specific integrations

⚡ Backend Team - Go Development

👨‍💻 Team Members

Ricardo Campos Senior Software Engineer

Maurício Bruno Senior Fullstack Engineer

Hiago Souza Senior Software Engineer

Francisco Soares Fluig Developer

Patrik Batista Student

🎯 Responsibilities

• Go API development and architecture
• Database design and optimization
• Docker containerization
• CI/CD pipeline management
• API documentation and testing

---

🚦 Getting Started

Prerequisites

• 🐳 Docker & Docker Compose
• 📱 Xcode 16.4+ (for iOS)
• 🤖 Android Studio (for Android)
• 🌐 Node.js 18+ (for Web)

🔧 Quick Setup

🌐 Web Development

# Coming soon - Web frontend setup
cd web/
npm install
npm run dev

📱 iOS Development

# Navigate to iOS project
cd ios/Posts/

# Open in Xcode
open Posts.xcodeproj

# Or use Xcode command line
xcodebuild -project Posts.xcodeproj -scheme Posts

Requirements:

• macOS 15.5+
• Xcode 16.4+
• iOS Simulator or physical device

🤖 Android Development

# Coming soon - Android setup
cd android/
./gradlew build
./gradlew run

⚡ Backend Development

# Navigate to backend directory
cd backend/

# Copy environment file
cp .env.example .env

# Start with Docker Compose
docker-compose up

# API will be available at http://localhost:8080

Environment Variables:

SERVER_PORT=8080
POSTGRES_HOST=db
POSTGRES_USER=forja_user
POSTGRES_PASSWORD=your_password
POSTGRES_DB=forja_posts
POSTGRES_PORT=5432

---

📁 Project Structure

forja-labs-posts/
├── 🌐 web/                    # React.js Web Application
│   ├── src/
│   ├── components/
│   └── package.json
├── 📱 ios/                    # iOS SwiftUI Application
│   └── Posts/
│       ├── Posts/
│       │   ├── App/           # App entry point
│       │   ├── Scenes/        # VIP scenes
│       │   └── Assets.xcassets/
│       └── Posts.xcodeproj
├── 🤖 android/                # Android Kotlin Application
│   ├── app/
│   ├── gradle/
│   └── build.gradle
├── ⚡ backend/                # Go Backend API
│   ├── cmd/                   # Application entry
│   ├── internal/              # Private application code
│   │   ├── core/              # Business logic
│   │   └── infra/             # Infrastructure
│   ├── config/                # Configuration
│   └── docker-compose.yml
├── 📚 docs/                   # Documentation
└── 🔧 .github/               # CI/CD workflows

---

🎯 Key Features

📝 Article Management

• ✅ Create, read, update, delete articles
• 🏷️ Categorization and tagging
• 🔍 Search and filtering
• 📊 Analytics and insights

👤 User System

• 🔐 Authentication and authorization
• 👥 User profiles and preferences
• 🎨 Customizable themes
• 📱 Cross-platform synchronization

🚀 Performance

• ⚡ Optimized for all platforms
• 📦 Efficient data loading
• 🔄 Real-time updates
• 💾 Offline capabilities

---

🔄 Development Workflow

📋 Pull Request Process

1. 🌿 Create feature branch from main
2. 💻 Develop and test locally
3. 🧪 Run all tests and linting
4. 📝 Create PR with template
5. 👀 Code review from team members
6. ✅ Merge after approval

🧪 Testing Strategy

• Unit Tests: All business logic
• Integration Tests: API endpoints
• UI Tests: Critical user flows
• E2E Tests: Cross-platform features

🚀 Deployment

• Staging: Automatic deployment on PR merge
• Production: Tagged releases
• Mobile: App Store & Play Store releases

---

📊 Project Status

Platform	Status	Version	Last Updated
🌐 Web	🔄 In Development	v0.1.0	Coming Soon
📱 iOS	✅ Active Development	v1.0.0	Active
🤖 Android	🔄 Planned	v0.1.0	Coming Soon
⚡ Backend	✅ Active Development	v1.0.0	Active

---

🤝 Contributing

We welcome contributions from all team members! Please see our Contributing Guidelines for details.

🎯 Quick Links

• 🐛 Report Bug
• 💡 Request Feature
• 📝 Pull Request Template

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🌟 Built with ❤️ by the Forja Labs Team

🐛 Report Bug • 💡 Request Feature • 📖 Documentation