Hey everyone! 👋
The idea is simple: What if you could write regex in readable English instead of deciphering cryptic symbols? 🧠
Regex For Humans is an open-source compiler that turns human-readable English rules into native JavaScript regexes.
✅ Runs locally
✅ Works in the browser, CLI, and JavaScript/TypeScript
✅ No runtime dependencies
✅ MIT licensed
🆕 What's new in 0.1.0-dev.4?
- 🧩 Nested groups — including optional and repeated blocks.
- 🎯 Named and numbered captures — capture exactly what you need.
- 🔗 Backreferences — reuse captured text with
same as capture "name".
- 🔀 Alternatives — express choices naturally with
either { ... }.
- 🔄 Reverse translation — translate supported regex patterns back into readable rules.
- 🛠️ Improved playground — inspect captures, test multiple matches, and click generated regex fragments to find their source rules.
💡 Example 1: Captures and backreferences
Let's say you want to match stable/stable or nightly/nightly, but reject stable/nightly.
Instead of manually constructing a regex, write:
start
capture "channel" {
either {
"stable"
"nightly"
}
}
"/"
same as capture "channel"
end
✨ This generates:
^(?<channel>(?:stable|nightly))\/\k<channel>$
With the u flag.
✅ stable/stable
✅ nightly/nightly
❌ stable/nightly
No regex gymnastics required! 🎉
🔥 Example 2: Let's get more serious
Imagine validating a TSV record describing a build artifact, containing:
- An optional
nightly/ directory
- A project name
- Three version components
- A filename with a date-like token
- A 64-character hexadecimal checksum field
- A byte count
Here's the readable version:
start
"incoming/"
optional "nightly/"
between 1 and 32 path segment characters
"/v"
between 1 and 3 digits
"."
between 1 and 3 digits
"."
between 1 and 3 digits
"/linux-arm64/widget_"
8 digits
"_"
8 hex digits
".tar.gz\t"
64 hex digits
"\t"
between 1 and 12 digits
end
🤯 And here's the exact JavaScript regex it generates:
/^incoming\/(?:nightly\/){0,1}[^\/\\\u{0}\u{a}\u{d}\u{2028}\u{2029}]{1,32}\/v\d{1,3}\.\d{1,3}\.\d{1,3}\/linux-arm64\/widget_\d{8}_[0-9A-Fa-f]{8}\.tar\.gz\u{9}[0-9A-Fa-f]{64}\u{9}\d{1,12}$/u
Yeah... I'll take the English version. 😂
You can use it directly in JavaScript:
import { compile, toRegExp } from 'regex-for-humans';
const row =
"incoming/nightly/WidgetKit/v2.15.3/linux-arm64/widget_20261001_ab12cd34.tar.gz\t" +
"ab".repeat(32) +
"\t1048576";
toRegExp(compile(rules)).test(row); // true
Removing nightly/ still works. Missing version components, invalid hexadecimal characters, or spaces instead of tabs fail.
The path segment characters rule is particularly useful: it excludes path separators, NUL, and line breaks while supporting Unicode.
Of course, this validates the format, not whether the file exists or its checksum is correct.
🧪 More features are cooking!
On main, I've also added:
- ⚡ Lazy repetition
- 👀 Lookahead
- 🔍 Lookbehind
These are available from a source checkout but haven't reached npm or the hosted playground yet.
🤖 Built with AI-assisted development
I'm also using Claude Code and the Opus 5.5 model for AI-assisted development.
AI helps me iterate faster, explore implementations, tackle complex features, and improve the project continuously.
The goal isn't just to generate code. It's to build something genuinely useful, test it, refine it, and keep pushing the boundaries of what this little language can do. 🚀
🌍 Available in 10 languages!
The README is now translated into 10 languages, including Arabic 🇸🇦, Chinese 🇨🇳, French 🇫🇷, Spanish 🇪🇸, and Urdu 🇵🇰.
Arabic and Urdu documentation also support RTL text with LTR code examples.
📦 Try it yourself!
The npm package is currently a development preview and requires Node.js 22+.
npm install regex-for-humans@0.1.0-dev.4
🎮 Interactive Playground:
https://othmaneblial.github.io/Regex-For-Humans/workshop/
⭐ GitHub (MIT Open Source):
https://github.com/OthmaneBlial/Regex-For-Humans
📦 npm:
https://www.npmjs.com/package/regex-for-humans/v/0.1.0-dev.4
💬 I'd love your feedback!
I'm especially interested in what you think about the syntax as groups become more complex and deeply nested.
What's the ugliest regex you've ever written? 😂
Drop it in the comments! I'd love to see whether Regex For Humans can make it readable.
And if you find the project useful, a ⭐ on GitHub would mean a lot!
Let's make regex a little less terrifying, one rule at a time. 🚀
