From d80586e1bb1e8c9f9c0f54d7b65b2c81b4cf1413 Mon Sep 17 00:00:00 2001
From: Eltrac <hi@guhub.cn>
Date: Mon, 15 Sep 2025 16:18:14 +0800
Subject: docs: create README.md

---
 README.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8e54da2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+# ♎️ Libra.js
+
+A lightweight, focused, vanilla JavaScript image lightbox library, only around **3.3KB** after minified.
+
+## Usage
+
+Grab [libra.min.js](https://github.com/BigCoke233/libra/blob/master/dist/libra.min.js) and put it in your project.
+
+Then import it as a module:
+
+```html
+<script type="module">
+  import LightBox from '/dist/libra.min.js';
+  const lightbox = new LightBox({
+    container: '.libra' // where your images are contained
+                        // e.g. if your post content is in a div with class "post-content"
+                        //      then you can set container: '.post-content'
+  });
+</script>
+```
+
+Also, include [libra.css](https://github.com/BigCoke233/libra/blob/master/src/libra.css).
+
+```html
+<link rel="stylesheet" href="/src/libra.css" />
+```
+
+## Development
+
+```
+npm install
+npm run test
+```
+
+The `test` command runs Parcel in watch mode.
+
+## Why?
+
+I've been using [Fancybox](https://fancyapps.com/fancybox/) for a long time. While it is an excellent library, it also includes lots of features I don't need. After searching available alternatives, I found most of them either not well maintained or just as heavy. So I developed Libra.js for my own use, and I hope you find it useful, too!
-- 
cgit v1.2.3