habibthadev

habibthadev / phoneng

Public

Zero-dependency TypeScript library for parsing, validating, normalizing, and formatting Nigerian phone numbers. Built with strict types, comprehensive validation, and production-grade error handling.

phoneng.vercel.app
10
1
100% credibility
Found Apr 16, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A lightweight library that parses, validates, normalizes, and formats Nigerian phone numbers, detects mobile networks, and handles batches with detailed summaries.

How It Works

1
😊 Discover Phoneng

You hear about a handy helper that straightens out messy Nigerian phone numbers for customer lists or apps.

2
🛠️ Bring it into your work

You easily add this phone number fixer to the place where you handle your contacts or data.

3
📱 Check one number

Paste in a phone number like 08031234567 and right away learn if it's good, which network like MTN it's on, and get neat versions to use.

4
📋 Fix a bunch at once

Give it a whole list of numbers from your spreadsheet or notes to clean them all together.

5
📊 Get the full report

See a quick summary showing how many are valid, how many aren't, and counts for each phone company.

🎉 Perfect contacts ready

Now your phone numbers are all validated, formatted nicely, and sorted – set to send messages or make calls without hassle.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is phoneng?

Phoneng is a zero-dependency TypeScript library built for parsing, validating, normalizing, and formatting Nigerian phone numbers. It solves the hassle of handling varied inputs—from local trunk prefixes like 0803 to E.164 international formats or even RFC3966—outputting clean versions like national, compact, or spaced international, plus network detection for MTN, Airtel, Glo, and others. Developers get strict types, comprehensive validation, and production-grade error handling without bundle bloat.

Why is it gaining traction?

Unlike heavyweight alternatives like libphonenumber, phoneng focuses solely on Nigerian numbers with zero runtime deps and a sub-10KB bundle, making it dead simple to drop into any TS project. Batch processing for bulk lists, fast isPossible checks, and detailed error codes like INVALID_PREFIX stand out for real-world reliability. The hook: full coverage of NCC-registered prefixes across all mobile networks, no config needed.

Who should use this?

Backend engineers at Nigerian fintechs validating user phones during onboarding. Frontend devs building forms for e-commerce or ride-hailing apps in Lagos. SaaS teams processing contact uploads or SMS campaigns targeting Naija users.

Verdict

Solid pick for Nigerian-specific phoneng needs despite low 10 stars and 1.0% credibility score—excellent docs, 95% test coverage thresholds, and MIT license signal maturity potential. Use it now if you need lightweight, reliable phone number handling; fork or contribute to push it forward.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.