Skip to content
Skip to content
Available for new work
Frontend systems & performance

AliMahmoud

Software Engineer

I build production-grade web applications with React, Next.js, and TypeScript — focused on performance budgets, accessibility, and shipping features users actually need.

  • Production projects shipped

    10+

    Freelance (Khamsat)

  • Client satisfaction rate

    100%

    5-star reviews

  • Payment gateways integrated

    6

    CleanDays

  • Client revenue uplift

    40%

    CleanDays

~/ali-mahmoud·edge-ready·perf-obsessed

Scroll to begin

01

Who I am

About

An engineer who happens to build for the web.

Ali Mahmoud
Available
Software Engineer

Now

2025-Q1
  • Building

    An open-source React performance dashboard (WIP)

  • Learning

    Distributed systems — reading Designing Data-Intensive Applications

  • Listening

    The Primeagen reacts + Lex Fridman

  • Location

    Suez, Egypt

01

Engineering over styling

I started as a front-end specialist but grew into a software engineer who happens to focus on the web platform. That distinction matters: I care about how a system behaves under load, how it fails, and how it evolves over time — not just how it looks on a Tuesday afternoon. My day-to-day work spans React 19, Next.js 16, edge runtime, and the occasional Prisma + PostgreSQL schema when a project needs persistence.

02

Performance is a feature

I treat Core Web Vitals as a contract, not a target. Every project I ship gets a Lighthouse pass before it goes to production, and I keep a running log of bundle sizes, Time to Interactive, and LCP. When I take over a slow codebase, the first thing I do is instrument it — you can't optimize what you can't measure, and most performance problems are obvious once the numbers are visible.

03

Shipping, not perfection

Freelancing on Khamsat for 10+ clients taught me that done is better than perfect — but 'done' has a real definition. For me, done means: deployed, tested, documented, and handed off with the client able to maintain it themselves. That mindset has carried into every project since, including the open-source work I'm starting to publish in 2025.

Currently focused on

  • Contributing to open-source React/Next.js ecosystem
  • Writing about web performance and edge computing
  • Deepening my system design fundamentals for scale

Based in Suez, Egypt — Remote-friendly. Open to remote roles and async-first teams across any timezone.

02

Where I've shipped

Journey

Three chapters of growth, three years of code.

  1. Apr 2025 — Present

    Freelance Front-End & Full-Stack Developer

    Self-employed · Khamsat Platform — Remote

    Delivering full-stack web applications for real clients across Saudi Arabia and Egypt. Owning the complete project lifecycle: requirement gathering, technical planning, implementation, deployment, and client handover.

    • Delivered 10+ web development projects on Khamsat, achieving 100% satisfaction rate with consistent 5-star reviews across all projects.
    • Built AI-powered medical platforms, complex pricing engines for Saudi businesses, and multi-gateway payment integrations (Mada, Visa, Mastercard, STC Pay, Apple Pay, Tabby, Tamara).
    • Implemented automatic PDF invoice generation with 15% Saudi VAT and handled end-to-end client communication in Arabic and English.
    React.jsNext.js 16TypeScriptTailwind CSS 4Framer MotionPrisma ORM
  2. Dec 2024 — Jun 2025

    Frontend Developer Diploma — Top Trainee

    Instant Software Solutions (ISS)

    Completed an intensive 7-month professional diploma focused on building production-ready web applications using React.js, Next.js, and modern JavaScript. Honored as the Top Trainee for outstanding performance during the program.

    • Honored as Top Trainee based on project quality, code reviews, and peer collaboration.
    • Developed interactive, user-facing features and reusable React components using ES6+, HTML5, and CSS3 with clean code and component-based architecture.
    • Optimized application performance reducing load times by 30%. Participated in code reviews and collaborative sessions using Git within an Agile framework.
    • Covered UI/UX design with Adobe XD, system analysis with ERD and UML diagrams, and professional freelancing skills.
    React.jsNext.jsTypeScriptTailwind CSSRedux ToolkitPrisma ORM
  3. 2025

    CS50x — Introduction to Computer Science

    Harvard University via edX

    Completed Harvard's CS50x — a rigorous introduction to computer science fundamentals including algorithms, data structures, and memory management. Applied concepts through hands-on projects in C, Python, and SQL.

    • Gained a solid foundation in algorithms, data structures, and memory management.
    • Applied concepts through hands-on projects in C, Python, and SQL.
    • Developed computational thinking and problem-solving skills applicable to all areas of software development.
    CPythonSQLAlgorithmsData Structures
03

What I've built

Work

Five production-grade projects. Real clients. Real impact.

Intelligent medical platform for preliminary diagnosis

Shifa

Lead Engineer (solo) · 2025

A bilingual (Arabic-first) intelligent medical platform for preliminary symptom diagnosis, AI-assisted health guidance, and doctor discovery — built with a focus on accessibility, privacy, and trust for Arabic-speaking users.

My Role

Owned the entire product end-to-end: requirements gathering with medical advisors, system architecture, full-stack implementation, deployment, and handoff. Made every technical decision from database schema to UI component design, with no team dependencies.

Problem

Arabic-speaking patients lacked a trustworthy, private symptom-triage tool in their native language. Existing English-only checkers don't account for MENA-region clinical context, RTL UX conventions, or cultural expectations around medical information.

Approach

Built a Next.js 16 application with route-level RTL handling, an AI inference layer for symptom analysis, and a custom component layer on Shadcn/ui primitives. Implemented JWT authentication with bcrypt password hashing, Prisma ORM + PostgreSQL for persistence, and a structured symptoms taxonomy organized by medical categories (general, respiratory, digestive, etc.).

Outcome

Shipped to production with full RTL support and zero layout regressions across LTR/RTL routes. Achieved Lighthouse 98 (Performance), 100 (Accessibility), 100 (Best Practices). 100% free for end users with complete privacy guarantees.

Key features

  • Smart symptom analysis with structured input (age, gender, symptom categories, free-text)
  • AI medical assistant 'Shifa' for real-time Q&A and drug information
  • Geo-located doctor search with Google Maps integration and specialty filters
  • User profiles with medical history, scoring system, and diagnostic log

Tech stack

Next.js 16TypeScriptTailwind CSS 4Shadcn/uiPrismaPostgreSQLJWT
01 / 05

Digital marketing landing page that converts

صعود (Suoad)

Freelance — Full Build · 2025

A professional, conversion-optimized landing page for Suoad — a Saudi digital marketing company. Built from scratch with full RTL support, custom interactive components, and SEO engineered from day one.

My Role

Worked directly with the Suoad founder to translate their sales pitch into an interactive landing experience. Handled the full lifecycle: discovery, design direction, frontend implementation, SEO strategy, deployment, and post-launch ad-campaign support.

Problem

Suoad needed a landing page that converted Saudi traffic into leads, but their existing template-driven site was generic, slow, and lacked the interactive storytelling their sales pitch relied on. The page had to load fast, rank well, and feel premium.

Approach

Built a Next.js 16 + React 19 landing page with Tailwind CSS 4. Implemented custom interactive components: a WhatsApp-style audio player with draggable progress bar, an image lightbox, and before/after comparison sliders. SEO was engineered from the ground up with Open Graph, Twitter Cards, structured data, and a perfect Lighthouse SEO score.

Outcome

100% client satisfaction. Lighthouse SEO score 98/100. The client immediately launched an ad campaign on the site with confidence in conversion quality — and reported back that the page held up under paid traffic without performance regressions.

Key features

  • Custom WhatsApp-style audio player with draggable progress bar
  • Interactive before/after comparison image sliders
  • Image lightbox with keyboard navigation
  • Comprehensive SEO: Open Graph, Twitter Cards, structured data

Tech stack

Next.js 16React 19TypeScriptTailwind CSS 4SEO
02 / 05

Cleaning services platform with pricing engine

CleanDays

Freelance — Full Build · 2025

A full-featured website for CleanDays — a leading Saudi cleaning services company. Features a real-time pricing engine for 8+ services, automatic PDF invoice generation with 15% Saudi VAT, multi-gateway payment integration, and seamless WhatsApp connectivity.

My Role

Owned the project end-to-end: requirement discovery with the CleanDays operations team, pricing engine design (including Saudi VAT compliance logic), payment gateway integrations, PDF invoice generation, deployment, and client training for content updates.

Problem

CleanDays was handling quotes manually via WhatsApp — slow response times, no upsell mechanism, no consistent pricing across services, and no way to enforce the mandatory 15% Saudi VAT. They were leaving money on the table with every inquiry.

Approach

Built a Next.js 16 + Tailwind CSS 4 application with Framer Motion choreography. Implemented a real-time pricing engine covering 8+ services with VAT logic, multi-gateway payment integration (Mada, Visa, Mastercard, STC Pay, Apple Pay, Tabby, Tamara), and automatic PDF invoice generation. Premium teal and gold identity with full RTL Arabic support.

Outcome

8+ services automated. 6 payment gateways integrated. +40% client revenue uplift from upsell flows alone. Replaced 100% of manual quoting within 2 weeks of launch — the WhatsApp quoting workflow was completely retired.

Key features

  • Real-time pricing calculator for 8+ cleaning services
  • Automatic PDF invoice generation with 15% Saudi VAT compliance
  • 6 payment gateways: Mada, Visa, Mastercard, STC Pay, Apple Pay, Tabby, Tamara
  • Seamless WhatsApp business integration for inquiries

Tech stack

Next.js 16TypeScriptTailwind CSS 4Framer MotionMulti-Gateway Payments
03 / 05

Cinematic luxury interior design studio website

ROUQY

Freelance — Design & Engineering · 2025

A cinematic single-page portfolio for ROUQY — a luxury interior design studio in Riyadh. Scroll-driven GSAP animations, an SVG logo that draws itself stroke-by-stroke, a horizontal scroll-jacked gallery, and a rotating circular-text WhatsApp CTA. Dark immersive aesthetic.

My Role

Owned both the design vision and the engineering implementation. Translated the studio's physical design language into a digital cinematic experience — chose the dark teal palette, choreographed the scroll animation sequence, hand-built the SVG logo draw effect, and shipped a JSON content layer so the client can self-serve post-launch.

Problem

ROUQY's previous site didn't match the craftsmanship of their physical work. They needed a cinematic, immersive experience that communicated luxury through motion and restraint — not a generic portfolio template. The client explicitly asked for the website to feel like 'walking through one of our designed spaces'.

Approach

Designed a dark immersive teal aesthetic with GSAP + ScrollTrigger for scroll-driven choreography. The ROUQY logo is rendered as an inline SVG path; on scroll, GSAP's strokeDashoffset technique draws the outline stroke-by-stroke, then fades in the fill — as if sketched in real time. On desktop, the logo then scales 7x and slides right to reveal the about section. Built a JSON-driven content layer so the client can update copy without touching code.

Outcome

100% client satisfaction. 5+ animation sections shipped. JSON-based content management enabled full client editability post-handoff — the studio updates their portfolio without developer involvement.

Key features

  • SVG logo self-draws stroke-by-stroke on scroll (GSAP strokeDashoffset)
  • Horizontal scroll-jacked gallery for portfolio showcase
  • Full-screen lightbox with prev/next controls
  • WhatsApp floating CTA with rotating circular text

Tech stack

Next.js 16TypeScriptGSAPScrollTriggerJSON CMS
04 / 05

Full-featured e-commerce learning project

React E-Commerce

Personal Project · 2024

A full-featured e-commerce application built with React.js featuring product filtering, shopping cart, and responsive design. Includes product search, category filtering, and a streamlined checkout flow.

My Role

Solo build, designed and implemented everything from scratch. Used this project to deeply learn React state management, component composition, and the e-commerce domain — every line of code is mine, with no tutorial hand-holding.

Problem

A learning project to internalize React fundamentals — component composition, state management, and the cart lifecycle — without the noise of a real backend. The goal was to build something production-shaped, not a tutorial clone.

Approach

Built with vanilla React.js and CSS3, using Context API for cart state. Implemented search, category filtering, and a streamlined checkout flow. Focused on responsive design across mobile/tablet/desktop, and wrote every component from scratch (no UI library) to internalize the patterns.

Outcome

Solidified my mental model of React state and component patterns. Became the foundation for the more complex Next.js apps that followed — the patterns I learned here (cart lifecycle, optimistic UI, debounced search) are still in my production code today.

Key features

  • Product search with debounced input
  • Category filtering and product sorting
  • Shopping cart with Context API state management
  • Streamlined checkout flow with form validation

Tech stack

JavaScriptReact.jsCSS3Context API

Each project ships with documentation, tests, and a clean handoff.

04

What I use

Stack

Tools grouped by job, not by hype.

Grouped by job, not by hype. I'm pragmatic about adding new tools — most production problems are solved by knowing a few things deeply, not many things superficially.

Languages

The syntax I think in.

01
  • TypeScriptPrimary, everywhere
  • JavaScriptES6+
  • PythonScripts & CS50x
  • SQLPostgres dialect

Frameworks

What I build on.

02
  • Next.js 16App Router + Edge
  • React 19Suspense + Actions
  • Tailwind CSSv4 design tokens
  • Radix UIAccessible primitives

State & Data

How state flows.

03
  • TanStack QueryServer state
  • ZustandClient state
  • React Hook FormForms + Zod
  • ZodSchema validation

Backend

Where data lives.

04
  • Node.jsRuntime
  • Prisma ORMType-safe queries
  • PostgreSQLPrimary DB
  • NextAuth.jsAuth

Testing

How I sleep at night.

05
  • VitestUnit
  • React Testing LibraryComponent
  • PlaywrightE2E
  • Lighthouse CIPerf budgets

Infra & Tools

How it ships.

06
  • VercelDeploy + Edge
  • GitHub ActionsCI/CD
  • ESLint + PrettierCode quality
  • ViteWhen not Next

Currently exploring: Rust (for CLI tools), Bun (as a runtime replacement), and React Server Components patterns for streaming UX.

05

Where to find me

Contact

Let's build something that ships.

06 — Contact

Let's build something that ships.

I'm open to senior frontend / software engineer roles at product-driven teams, and selective freelance work where performance and craft matter. The fastest way to reach me is email — I reply within 24 hours on weekdays.