From 5d467a82d725edb17958648c2606efe20a46325d Mon Sep 17 00:00:00 2001
From: Nirmal Kumar R <tildezero@gmail.com>
Date: Fri, 5 Jun 2026 03:42:00 +0530
Subject: [PATCH] feat: Add README

---
 README.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7f99bb4..fb36608 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,12 @@
-# nir
+# Nir
 
-Nir Programming Language
\ No newline at end of file
+A compiled, metaprogrammable systems language with Scheme semantics.
+
+- Native code via QBE backend
+- Lisp macros that compile to zero-overhead machine code
+- Two-zone memory model: managed GC + explicit arena allocation
+- DSLs as first-class language constructs
+
+**Status: Early development**
+
+[Documentation](https://nirlang.org) | [License: Apache 2.0]