wesal/README.md
2025-08-07 09:54:25 +03:00

1.6 KiB

Wesal App

A social networking mobile application designed for connecting workplace colleagues. Wesal (Arabic for "connection") enhances communication and collaboration among division members.

Features

  • Social Feed: Create, view, like, and comment on posts
  • Invitations: Create and manage event invitations with RSVP functionality
  • Daily Puzzles: Timed daily challenges with leaderboards (9AM-11AM)
  • Push Notifications: Stay engaged with real-time updates

Quick Start with Docker

  1. Clone and setup:

    git clone https://git.bubshait.me/sBubshait/wesal.git
    cd wesal
    chmod +x install.py
    sudo ./install.py
    
  2. Run the application:

    docker compose up --build
    
  3. Access the services:

Technology Stack

  • Frontend: Flutter 3.8.1+
  • Backend: Spring Boot 3.5.3 (Java 21)
  • Database: PostgreSQL
  • Authentication: JWT tokens
  • Notifications: Firebase Cloud Messaging
  • Deployment: Docker containerization

Documentation

For detailed technical documentation, installation guides, development setup, and troubleshooting, see: 📖 Complete Documentation

Development

See the full documentation for:

  • Manual setup instructions
  • Development commands
  • Testing procedures
  • API documentation
  • Troubleshooting guide

Support

Contact COD/DPSD for application support and maintenance information.