AREA - Action-REAction Platform (FORK)

Automation platform similar to IFTTT/Zapier, allowing users to create workflows by connecting Actions to REActions.

Project Structure

• Server (NestJS + PostgreSQL) - API on port 8080
• Web Client (React + Vite) - UI on port 8081
• Mobile Client (React Native) - Android/iOS app

All business logic resides on the server. Clients are stateless interfaces.

Quick Start

docker compose up

• Web: http://localhost:8081
• API: http://localhost:8080
• API Docs: http://localhost:8080/api-docs
• APK: http://localhost:8081/client.apk

Requirements

• Docker 20.10+
• Docker Compose v2+

Configuration

Create .env at project root:

DB_HOST=postgres
DB_USERNAME=area_user
DB_PASSWORD=your_password
DB_DATABASE=area_db

JWT_SECRET=your-jwt-secret

FRONTEND_URL=http://localhost:8081
VITE_API_URL=http://localhost:8080

See docs/SETUP.md for detailed configuration.

Stack

Component	Technology
Server	NestJS 11 + TS
Database	PostgreSQL 16
Web	React 19 + Vite
Mobile	React Native

Services Supported

• GitHub - Push, issues, pull requests, releases
• Discord - Messages, roles, channels
• Gmail - Email notifications and sending
• Microsoft - Outlook emails and Graph notifications
• Jira - Issue tracking and management
• Twitch - Stream events and channel updates

See API.md for complete actions and reactions list.

API

REST API documented with Swagger: http://localhost:8080/api-docs

Key endpoint: GET /about.json (server metadata)

Documentation

• Web Documentation
• Setup Guide
• API Reference
• Frontend Architecture
• Mobile Architecture
• How to Contribute
• Architecture

Contributing

See HOWTOCONTRIBUTE.md for adding services, actions, and reactions.

Useful Links

• Official status code
• Github documentation
• Oauth documentation
• PostgreSQL documentation
• NestJS documentation
• React documentation
• React Native

Security

Security documentation and audit reports:

• Security Audit - OWASP Top 10 2025 analysis
• Security Watch - CVE monitoring and updates

Authors

• Mattéo Milin - matteo.milin@epitech.eu
• Nathan Callegari - nathan.callegari@epitech.eu
• Corentin Bergaentzle - corentin.bergaentzle@epitech.eu
• Thomas Richalet - thomas.richalet@epitech.eu
• Axel Battigelli - axel.battigelli@epitech.eu

License

This project is developed for educational purposes as part of the EPITECH curriculum. See LICENSE for more informations