Skip to content

iDorgham/Gateflow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

396 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GateFlow Banner

GateFlow

Zero-Trust Digital Gate Infrastructure Platform
Secure, Auditable, and Marketing-First Access Control for the MENA Region

Status Stack Security


📋 Table of Contents


✨ What is GateFlow?

GateFlow is a next-generation digital gate infrastructure platform designed specifically for gated compounds, real estate developers, schools, clubs, marinas, and high-end venues across the MENA region.

GateFlow transforms physical access points into secure, trackable, and marketing-enabled digital nodes.

Vision: Stripe-level infrastructure for physical access — controlled entry + live intelligence + enterprise-grade security & integrations.


📱 The Six Apps Strategy

GateFlow consists of 6 interconnected applications working as one:

App Mode Description Status
Client Dashboard Web Main SaaS portal for property owners ✅ 1.0.0
Scanner App Native Offline-capable QR scanner for guards ✅ 1.0.0
Resident Mobile Native Resident self-service (iOS/Android) ✅ 1.0.0
Admin Dashboard Web Super-admin management for platform ✅ 1.0.0
Resident Portal Web Resident self-service (Web/Browser) ✅ 1.0.0
Marketing Site Web Public-facing conversion & blog ✅ 1.0.0


🚀 Key Features

🏗️ Core Platform

  • 🔲 QR Code System — Single, recurring, permanent, and visitor-created passes.
  • 🏢 Multi-Project Support — Organize access by compound, event, or building.
  • 👥 Team & RBAC — Granular role-based access control for every organization.
  • 📊 Real-Time Analytics — Live scan feed (SSE) and deep-dive reporting.
  • 🤝 Resident Autonomy — Unit-linked guest management with quota tracking.

🛡️ Security Operations

  • 🔒 HMAC-SHA256 QR Signing — Cryptographically signed signatures prevent forgery.
  • 🔐 Zero-Trust Auth — Argon2id password hashing and JWT sessions.
  • 🏷️ Watchlists — Instant blocking and incident creation for restricted entities.
  • ids Identity Verification — 3-level verification from basic info to ID capture.
  • 📍 Shift Tracking — Accountability for gate operators and supervisors.

💻 Tech Stack

Component Technology Version
Web Frontend Next.js 14 (App Router) 14.2.x
Mobile Apps React Native (Expo SDK 54) 54.x
Database PostgreSQL 15+
ORM Prisma 5.x
Styling Tailwind CSS 3.4.x
Security Argon2id + HMAC-SHA256 Latest
Build System Turborepo + pnpm 2.x

🏗️ Architecture

📁 Structure

GateFlow/
├── apps/               # The 6 core interactive apps: Next.js + Expo
├── packages/           # Shared logic: db, types, ui, i18n, api-client
├── docs/               # Technical and product documentation
└── turbo.json          # Monorepo build orchestration

🛠️ Quick Start

📋 Prerequisites

  • Node.js 20+ (LTS recommended)
  • pnpm 8+ (npm install -g pnpm)
  • PostgreSQL 15+

📥 Installation

# Clone the repo
git clone https://github.com/iDorgham/Gateflow.git && cd Gateflow

# Install everything
pnpm install

# Setup database (in packages/db)
npx prisma migrate dev && npx prisma db seed

# Run local development
pnpm turbo dev

📖 Documentation Index

Repo Location Description
Docs Home Entry point for all technical and product documentation.
Product PRD The definitive scope and requirements for GateFlow v1.0.
Architecture System design, database schema, and security flow.
Deployment Guides for Vercel, Expo, and CI/CD pipelines.
Security Deep dive into HMAC signing, encryption, and RBAC.

© 2026 GateFlow. Built for the modern MENA gate.

About

Physical access control systems today operate in isolation from marketing and business intelligence. Real estate developers, gated compounds.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors