From d3b1b50ed72b37e79914d5d04cd3337fee58bba6 Mon Sep 17 00:00:00 2001
From: Per Ryan Edin <ryan@helloryan.se>
Date: Thu, 9 Jul 2026 03:49:46 +0200
Subject: [PATCH] Add README

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

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..993b457
--- /dev/null
+++ b/README.md
@@ -0,0 +1,61 @@
+[![Made with Love][made-with-love-badge]](https://bitshift.helloryan.se/)
+[![Discord][discord-badge]][Discord]
+
+BitShift
+========
+
+The **BitShift** software collection.
+
+Join the BitShift [Discord] to discuss all things related to BitShift and
+programming!
+
+## Software
+
+- [bitshift/bitshift-framework][bitshift/bitshift-framework]
+- [bitshift/bitshift-validate][bitshift/bitshift-validate]
+
+### Upcoming Projects:
+
+- bitshift/bitshift-bql
+- bitshift/bitshift-declare
+- bitshift/bitshift-golink
+- bitshift/bitshift-hyperlane
+- bitshift/bitshift-hyperlane-ng
+- bitshift/bitshift-hyperlane-studio
+- bitshift/bitshift-json
+- bitshift/bitshift-narvik
+- bitshift/bitshift-paperback
+- bitshift/bitshift-seafire
+- bitshift/bitshift-symgen
+
+### Ideas?
+
+Let us know if you need help realizing an idea, we'd be happy to help. Contact
+us via [e-mail] or [Discord][Discord].
+
+## Documentation
+
+BitShift documentation:
+
+- bitshift/narvik-definition
+- bitshift/narvik-developers-guide
+- bitshift/seafire-developers-guide
+
+## Meta
+
+BitShift meta-information:
+
+- [bitshift/knowledge-base]
+- [bitshift/tasks]
+
+[made-with-love-badge]: https://img.shields.io/badge/Made_with_%E2%9D%A4%EF%B8%8F_by-The%20BitShift%20Contributors-ff2010?style=for-the-badge&labelColor=black
+[discord-badge]: https://img.shields.io/discord/1444936129718522024?style=for-the-badge&logo=discord&logoColor=white&label=Discord&labelColor=000000&color=green
+
+[Discord]: https://discord.gg/96cBuVgVMS
+[e-mail]: mailto:bitshift@helloryan.se
+
+[bitshift/bitshift-framework]: https://code.helloryan.se/bitshift/bitshift-framework
+[bitshift/bitshift-validate]: https://code.helloryan.se/bitshift/bitshift-validate
+
+[bitshift/knowledge-base]: https://code.helloryan.se/bitshift/knowledge-base
+[bitshift/tasks]: https://code.helloryan.se/bitshift/tasks