From c65ab834f5e63b3c8740a27ff9592be7336c3d6e Mon Sep 17 00:00:00 2001
From: Jooris Hadeler <jooris@hadeler.me>
Date: Thu, 23 Apr 2026 18:56:10 +0200
Subject: [PATCH] feat: add `README.md` and repository link

---
 README.md      | 41 +++++++++++++++++++++++++++++++++++++++++
 extension.toml |  1 +
 2 files changed, 42 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5bfe23e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+# EBNF for Zed
+
+A [Zed](https://zed.dev/) extension that provides comprehensive language support for Extended Backus-Naur Form (EBNF).
+
+## Features
+
+- **Syntax Highlighting:** Vibrant and accurate highlighting for EBNF rules, strings, integers, and special sequences.
+- **Bracket Matching:** Support for rainbow brackets and active bracket highlighting for standard brackets `()`, `{}`, `[]`, as well as EBNF-specific sequences like `(/ /)` and `(: :)`.
+- **Auto-Closing & Indentation:** Smart bracket auto-closing and indentation behaviors when writing rules.
+- **Outline Panel Support:** Quickly navigate large grammar files using Zed's Outline panel (`cmd-shift-O` or `ctrl-shift-O`).
+
+## Installation
+
+### From the Zed Extension Registry (Coming Soon)
+1. Open Zed.
+2. Open the Command Palette (`cmd-shift-p` / `ctrl-shift-p`).
+3. Search for **`zed: extensions`**.
+4. Search for **EBNF** and click **Install**.
+
+### Local Development / Manual Installation
+If you want to install this extension manually or tweak it:
+
+1. Clone this repository:
+   ```bash
+   git clone [https://git.hadeler.me/jooris/zed-ebnf.git](https://git.hadeler.me/jooris/zed-ebnf.git)
+   ```
+
+2.  Open Zed.
+3.  Open the Command Palette (`cmd-shift-p` / `ctrl-shift-p`) and search for **`zed: extensions`**.
+4.  Click the **Install Dev Extension** button.
+5.  Select the cloned `zed-ebnf` directory.
+
+## Example EBNF
+
+Once installed, `.ebnf` files will automatically be highlighted:
+
+```ebnf
+(* A simple EBNF grammar *)
+digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" ;
+number = digit , { digit } ;
+```
diff --git a/extension.toml b/extension.toml
index 65a8963..6670fe3 100644
--- a/extension.toml
+++ b/extension.toml
@@ -4,6 +4,7 @@ version = "0.0.1"
 schema_version = 1
 authors = ["Jooris Hadeler <jooris@hadeler.me>"]
 description = "Syntax highlighting for Extended Backus-Naur Form (EBNF)"
+repository = "https://git.hadeler.me/jooris/zed-ebnf"
 
 [grammars.ebnf]
 repository = "https://git.hadeler.me/jooris/tree-sitter-ebnf"