Skip to content
Mahmoud Farouk

I design and build software that is reliable

Full-stack software engineer with 8+ years building web products end to end, from Angular and React interfaces to Java and Spring Boot backends. Available for freelance full-stack, backend and architecture projects.

Taking on new freelance projects. Replies within one business day.

  • Principal Software Engineer at CIT Vericash
  • Previously B.TECH and Egabi Solution
  • Creator of Arab Enterprise Kit
Mahmoud Farouk, principal software engineer, smiling in a grey suit and blue tie

Three ways I can help

Pick the one that matches your problem today. Most projects start with the first and grow into the others.

Products I have built and shipped

Watch them run. The demos start when they scroll into view and pause when you move on.

  • A Haris approval card asking to open Notepad, with Deny, Allow for session and Allow once buttons and a line saying the result goes to Claude.
  • The Haris Security drawer showing loopback-only network, a verified session token, keys in the OS credential vault and 25 allow-listed tools, with a sentence on which tools wait for a click.
  • The Haris interface in Arabic with a right-to-left layout, the guardian emblem and a conversation in which it introduces itself.

Haris

A security-first desktop AI assistant for Windows that talks, listens and acts on your PC without trusting the model, in English or Arabic (right to left). Open source under the MIT license. Now at version 0.6.0, which adds a Stop button that ends a reply mid-answer.

Role: Creator and maintainer

  • Every tool call passes a permission gate: read-only and low-risk tools run and are logged; anything that opens apps, changes files, touches the clipboard, screen or camera, or powers off waits for your click
  • Approvals come only from your click: never from voice, never from another AI model
  • Choose the engine: Claude, Ollama or LM Studio, any OpenAI-compatible API, or Ollama on a free Google Colab GPU
  • The core binds to 127.0.0.1 only, keys stay in Windows Credential Manager, memory is encrypted with AES-256-GCM, and it installs per user with no administrator rights
  • Java 21
  • Spring Boot 4
  • Vite
  • Docker
  • Vosk
  • Windows Credential Manager

The installer is not code-signed yet: check the SHA-256 in the release notes and unblock the zip.

  • The Cash page in Arabic with a right-to-left layout: money in, money out, net, recorded expenses, and expected and overdue totals in Saudi riyals.
  • An Arabic tax invoice PDF with unit price, discount, net, VAT rate, VAT and total on each line, and the totals in Saudi riyals.
  • The Arab Enterprise Kit sign-in screen asking for a six-digit authentication code.
Arab Enterprise Kit logo

Arab Enterprise Kit

A multi-tenant starter kit for Arabic SaaS and ERP systems, with right-to-left support from the screen to the PDF export. Now at version 5.4.2: the 5.4 finance pack adds tax invoices with VAT per line, bank and wallet reconciliation and a cash view, on top of tenant checks on every lookup by id and enforced two-factor sign-in. Live on Gumroad.

Role: Creator and lead architect

  • Full right-to-left support in the interface and in generated PDFs
  • High-performance Excel import and export
  • Docker-ready, with role-based access control, two-factor sign-in and a modern dashboard
  • Tax invoices in English and Arabic, and reconciliation that suggests matches for a person to confirm
  • E-invoicing: ZATCA is sandbox-tested and not certified; sending to Egypt's ETA is tested against a local stand-in for its API
  • Spring Boot
  • PrimeNG
  • Tailwind CSS
  • Docker
  • RBAC

The Definitive Guide to B2B SaaS Architecture

A 37-page guide to every decision behind Arab Enterprise Kit: modular monolith versus microservices, multi-tenant data isolation and what to choose first, and why. Written for founders, agency owners and tech leads who need to scope a B2B SaaS before they hire or build.

Read the guide on Gumroad (opens in a new tab)

Listen: the version 5.3 launch

A 16 to 23 minute AI-generated discussion of the earlier Arab Enterprise Kit 5.3 release, made with NotebookLM from the product documentation, in English and in Arabic. The kit is now at 5.4.2. Two synthetic hosts, not me, so treat the facts on this page and the Gumroad listing as the reference.

English (23 min)
Arabic (16 min)
  • A closed cashier shift with opening float, cash sales, refunds, expected and counted cash, a difference of minus five Egyptian pounds and sales by payment method, beside the headline Close the shift. See the difference.
  • The point of sale cart in dark theme with an open payment method list showing Cash, Card, InstaPay and Vodafone Cash.
  • A Z-report for shift one at a shop called Nile Mart, with opening and closing times and the cash drawer figures.

Inventory Shop Management

A self-hosted inventory, point-of-sale and purchasing system for small shops, with an AI assistant that answers from the shop's own live data. Now at version 1.2.1: the 1.2 finance pack adds cashier shifts, local payment methods, reconciliation and tax invoices.

Role: Creator and lead architect

  • Touch-friendly checkout with barcode search, receipts, refunds and offline sales that sync later
  • Stock ledger per item, purchase orders that add stock on receipt, and low-stock alerts
  • Cashier shifts with a cash-drawer close and a Z-report, local payment methods recorded by name, and matching a provider's daily payout to that day's sales
  • Multi-tenant core with tenant checks on every lookup, roles, two-factor sign-in, English, Arabic (right to left) and French
  • E-invoicing: ZATCA is sandbox-tested and not certified; sending to Egypt's ETA is tested against a local stand-in for its API
  • Spring Boot
  • Java 25
  • Angular
  • PostgreSQL
  • Docker
  • Ollama
  • A finished Instagram post in Egyptian Arabic with the AI-generated label, its other language versions and the script, under the headline Every ad keeps its script and images.
  • The Brand kits page and the edit dialog for a kit called Oud House with a colour, tone notes and words to avoid, under the headline Each client keeps its brand.
  • The AdPlatformForge dashboard in Arabic with a right-to-left layout, credits and recent ads, under the headline Full Arabic interface, right to left.

AdPlatformForge

A multi-tenant SaaS that turns one product photo into short video ads and social designs in Modern Standard, Egyptian, Gulf, Levantine and Hassaniya Arabic and in French, with live progress and credit billing. Now at version 1.2.2: the 1.2 release adds brand kits per client and up to four language versions from one photo.

Role: Creator and lead architect

  • Async pipeline: photo analysis, background clean-up, script writing, moderation, then render
  • Brand kits with colour, logo, tone notes and banned terms: a banned term in the brief is refused before any credit is charged
  • Consent-gated likeness controls with an approval queue, usage log and instant kill switch, plus two-factor sign-in and account lockout
  • Credit ledger with automatic refunds, plus a pay-then-verify flow for local mobile wallets
  • Spring Boot
  • Angular
  • PostgreSQL
  • FFmpeg
  • Stripe
  • Claude API
  • fal.ai

Developer Portfolio Template

A portfolio site template for developers and freelancers: edit one content file and get a fast, accessible, SEO-ready site with a contact form and interactive effects written without an animation library. Now at version 1.1.1.

Role: Creator

  • One content file drives every section: hero, projects, services, process and contact
  • Rotating headline, spotlight cards, scroll tilt and a process timeline, all with reduced-motion fallbacks
  • Unit tests, browser tests and accessibility checks included, plus a live demo
  • Next.js 16
  • React 19
  • Tailwind CSS v4
  • TypeScript
  • Playwright

MyReads

A bookshelf app: search for books and move them between Currently Reading, Want to Read and Read.

Role: Developer

  • Move any book between shelves from a menu on its cover
  • Add new books to your library with one button
  • Covers, titles and authors laid out for quick scanning
  • React
  • REST API

Need something like this for your business?

Tell me what you are building. I reply within one business day with questions or a plan.

Start a Project with Me

What happens after you get in touch

Tell me the problem. Get a written proposal. Watch it get built.

  1. Discovery call

    A free 30-minute call. You describe the problem and what a good result looks like.

  2. Written proposal

    Scope, architecture approach, timeline and price in writing, before any work starts.

  3. Build and handover

    Iterative delivery with tests and documentation, then a handover session for your team.

Portrait of Mahmoud Farouk in an office

Based in Cairo, Egypt. Works remotely with teams in any time zone.

An engineer who takes a product from idea to production

I have spent eight years building and running business software end to end: interfaces, APIs, databases and delivery. Today I am a principal software engineer at CIT Vericash, where I standardize backend architecture and move legacy monoliths to microservices.

Outside work I ship my own products: a multi-tenant inventory and point-of-sale system, an AI ad studio, the Arab Enterprise Kit and Haris, an open-source desktop assistant. Earlier I built enterprise integration middleware at B.TECH and government web applications at Egabi Solution, and tuned Oracle databases along the way.

As a freelancer I bring the same approach to smaller teams: understand the problem, design the simplest architecture that will last, then build it with tests.

What I work with

Backend
Java, Spring Boot, Spring Cloud, Spring Security, JPA and Hibernate
Architecture
Microservices, event-driven design, modular monolith, REST, design patterns
Data and messaging
Oracle, PostgreSQL, MySQL, MongoDB, Redis, Kafka, RabbitMQ, Flyway
Frontend
Angular, React, TypeScript, Node.js, Sass
Delivery
Docker, Jenkins, Maven, OpenAPI, JUnit 5, Mockito, TDD

Where I have worked

  1. CIT Vericash

    Software Development Principal (earlier Specialist and Senior Developer). June 2023 to now.

  2. B.TECH

    ESB Senior Specialist. August 2022 to June 2023.

  3. Egabi Solution

    Associate Consultant to Software Development Specialist. April 2018 to August 2022.

  4. Faculty of Computing and Information

    BSc Computer Science, Zagazig University. 2016.

Training and certifications

  • Angular Deep Dive, Beginner to Advanced (Udemy, 2026)
  • Software Architecture Foundations and Intro to Microservices (Packt, Coursera, 2026)
  • Oracle SQL Performance Tuning Masterclass (Udemy, 2025)
  • Building Scalable Java Microservices with Spring Boot and Spring Cloud (Google Cloud, Coursera, 2025)
  • Java Full Stack Developer Specialization (Board Infinity, Coursera, 2025)
  • Microservices Architecture: The Complete Guide (Udemy, 2024)
  • React Development Cross-Skilling Nanodegree (Udacity, 2021)

Languages: Arabic (native), English (B2).

Start a project

Describe the problem in a few lines. I reply within one business day with questions or a time for a free 30-minute call.

View My Resume (PDF, opens in a new tab)

A few lines is enough: at least 40 characters.