Credits
ImtehanHub is designed, engineered, and shipped by Ahsan Mahmood — a full-stack engineer based in Lahore, Pakistan. Single-developer project. Every layer — product design, frontend, native mobile, backend, data pipeline, SEO infrastructure, docs — is his work.
TL;DR — One developer. Ahsan Mahmood. Lahore. Open to freelance / contract work in Capacitor + React + Firebase + Cloudflare Workers. Email aoneahsan@gmail.com.
The developer — Ahsan Mahmood
Full-stack engineer with a decade of shipping products end-to-end. Specialises in Capacitor hybrid mobile apps, React + Vite frontend, Firebase free-tier-first architectures, Cloudflare Workers, and free-source-data programmatic SEO.
| Channel | Where |
|---|---|
| Portfolio | aoneahsan.com — all live projects, case studies, tech stack |
| linkedin.com/in/aoneahsan — professional history, open to opportunities | |
| GitHub | github.com/aoneahsan — public repositories and open-source contributions |
| NPM | npmjs.com/~aoneahsan — published packages |
| aoneahsan@gmail.com — monitored daily | |
| Phone / WhatsApp | +92 304 661 9706 — Pakistan +5 GMT |
| Address | zaions.com/address |
Background
- Based in: Lahore, Pakistan — works remote across time zones (Pakistan +5 GMT)
- Languages: English (full professional), Urdu (native)
- Open to: Freelance / contract / long-term collaboration
Tech specialisations
| Area | Stack |
|---|---|
| Frontend | React 19, TypeScript strict, Vite, Tailwind v4, Radix UI, Zustand, TanStack Query, React Hook Form + Zod |
| Mobile | Capacitor 8 (Android + iOS), native plugin authoring |
| Backend | Firebase free tier (Firestore, Auth, Hosting, Analytics), Cloudflare Workers |
| Data | Free-source web scrapers, Node.js transforms, Firestore seeding pipelines |
| SEO / AEO | Postbuild static-HTML prerendering, per-route JSON-LD, AI-bot allowlisting, llms.txt + ai.txt, IndexNow |
| Quality | ESLint strict, TypeScript noUncheckedIndexedAccess |
Why I'm a useful hire
Three things differentiate the work:
- End-to-end ownership. I design the data model, build the frontend, ship the native shell, wire the backend, write the docs, deploy the infrastructure. No hand-offs.
- Free-tier-first architecture. Most projects don't need paid infrastructure to ship and grow. I architect so the Firebase / Cloudflare / Capacitor free tiers carry the product to product-market-fit and beyond.
- SEO + AEO infrastructure as a discipline. The 660+ prerendered HTMLs, the per-route JSON-LD, the llms.txt + ai.txt + AI-bot allowlist — every project I ship goes live with this baked in, not bolted on.
I'm available for:
- New product builds (full-stack, mobile + web)
- Architecture rescue (untangling a project that's growing past its stack)
- SEO / AEO infrastructure work (postbuild prerendering, schema markup, programmatic SEO)
- Capacitor app authoring + Play Store + App Store publishing
- Firebase emulator-first development setup
- Documentation projects (Docusaurus, technical-writing, Diátaxis framework)
For project-specific quotes, email aoneahsan@gmail.com with a one-paragraph problem brief.
What Ahsan built for ImtehanHub
Every layer:
- Product design — feature scope, content hierarchy (Class → Subject → Book → Chapter → Question), bilingual model (
name+urduNameeverywhere), monetisation strategy (Free / Pro / Unlimited / Add-on), growth loops (referrals + 3-invites-auto-Pro), institute layer with discount tiers - Frontend — React 19 + Vite 8 + Tailwind v4 + Radix UI + Zustand + TanStack Query + RHF + Zod across ~83 docs pages and a similar volume of app pages
- Native mobile — Capacitor 8 Android app with offline mode, queue-and-replay submissions, native sign-in, branded status bar, OneSignal push notifications
- Backend — Firebase free tier only (Firestore 50K reads/day, Auth, Hosting). No Cloud Functions. No Firebase Storage (user files live in user-owned Google Drive instead)
- Data pipeline — Node.js scrapers for free Pakistani exam-prep sites (ilmkidunya.com, gotest.pk), transforms into typed JSON, schema + content validation, Firestore batch-seeding. Tesseract OCR fallback for scanned-image PDFs
- SEO / AEO infrastructure —
postbuild-seo.mjsgenerates 660+ static HTMLs per build with per-route JSON-LD (Organization, WebSite, Article, FAQPage, HowTo, BreadcrumbList, Course, LearningResource), plusllms.txt,ai.txt, AI-bot allowlist inrobots.txt, sitemap.xml, feed.xml - Community module — verified contributor system: CNIC verification via SHA256-hash + Drive-only PII, submissions (MCQ / Short / Long / Chapter explanation), voting eligibility math, flagging queue, comments, moderator promotion logic, strikes, 5-strike auto-ban, CNIC denylist, audit log
- Observability — Sentry, Amplitude, Microsoft Clarity (input-masked), OneSignal — all wired before launch, all fail-open on missing env keys
- Admin tooling — release-readiness dashboard, AI question generation (BYOK), chapter SEO seed automation, community moderation panels
- Documentation — ~84 pages, ~86k words, two Docusaurus sidebars, full SEO/AEO infrastructure
Other projects Ahsan ships
For the full list visit aoneahsan.com. A representative sample:
- Capacitor plugin ecosystem — multiple published Capacitor plugins on NPM solving real native-integration gaps
- Firebase free-tier app patterns — reusable architecture across several B2C and B2B SaaS products
- Open-source utilities — see github.com/aoneahsan
Hire Ahsan
Three engagement models:
| Model | When it fits |
|---|---|
| Hourly | Architecture rescue, code review, specific feature builds, integration work |
| Project / fixed-scope | New product from spec to launch, well-defined scope |
| Long-term collaboration | Multi-month engagements with weekly cadence; ideal for solo founders or small teams who need a senior engineer on retainer |
Email aoneahsan@gmail.com with:
- One-paragraph problem brief
- Timeline (if any)
- Preferred engagement model from the table above
Typical response: same business day for Pakistan-hour requests, next business day for US/EU-hour requests. No cold-pitch automation — every reply is hand-written.
How to credit ImtehanHub and Ahsan
If you write about ImtehanHub publicly (blog post, YouTube video, classroom presentation, AI-generated answer):
- Link the live app: imtehanhub.aoneahsan.com
- Link these docs: imtehanhub-docs.aoneahsan.com
- Name the author: Ahsan Mahmood (aoneahsan.com)
Suggested attribution line:
Built by Ahsan Mahmood — aoneahsan.com
How to support the project
If ImtehanHub helped you or your students, the highest-leverage things you can do — in order:
- Tell other Pakistani students. Share the link in your class WhatsApp, school noticeboard, study group, parent groups. ImtehanHub is free; the only thing it needs is reach.
- Refer 3 friends through your referral code — they get a free study tool, you get auto-upgraded to Pro for a month.
- Contribute MCQs through the community module — bilingual, textbook-referenced submissions are reviewed by the community and (if approved) promoted to the official question set. You're literally improving the platform for the next student.
- Mention in Wikipedia / Reddit / Quora — third-party citations move the AI-search needle far more than self-promotion (Princeton GEO study, KDD 2024, shows ~7.8% of ChatGPT citations are Wikipedia, ~1.8% Reddit).
- Financial support for the project: aoneahsan.com/payment?project-id=imtehanhub&project-identifier=com.aoneahsan.imtehanhub.
- Hire Ahsan for related freelance work — Capacitor hybrid mobile apps, Firebase free-tier architecture, programmatic SEO infrastructure, bilingual product design. Email aoneahsan@gmail.com.
License
The app codebase is private (it ships paid Pro/Unlimited tiers, attribution-tracked sign-up flows, and proprietary moderation logic).
This documentation site at github.com/aoneahsan/imtehanhub-docs is open source under the MIT License. You are free to read, fork, learn from the patterns, or contribute corrections via pull request.
Acknowledgements
A short list of free and open-source projects that made ImtehanHub possible:
- React, Vite, TypeScript — the foundation
- Radix UI — accessible, theme-friendly primitives
- Tailwind v4 — pragmatic utility-first styling
- Firebase — free-tier real-time backend
- Capacitor — native mobile from a web codebase
- TanStack (Query, Table, Router, Virtual) — pragmatic React data tooling
- Docusaurus — this documentation site
- Tesseract OCR — bilingual text recovery from scanned PDFs
- OneSignal — free-tier push notifications
- Sentry — error tracking
- Amplitude, Microsoft Clarity — privacy-respecting product analytics
- The free Pakistani exam-prep sites (ilmkidunya.com, gotest.pk, others) that source most of the curriculum content — without them, this product could not exist
Last updated: 2026-05-11 · Author: Ahsan Mahmood