first setup

README.md

@@ -1,3 +1,19 @@
 # x-icu
+> **The lightweight bridge to ICU data.**
 
-x-icu is a python utility which fetches ICU data and compacts them into a binary, adding only the desired features. Good if you only use a couple of ICU features.
+---
+
+### What is x-icu?
+`x-icu` streamlines the way you handle Unicode data. It automatically fetches data from the **International Components for Unicode (ICU)**, parses it within a Python notebook, and generates a compact **binary map** for your program to interpret.
+
+### Why use it?
+* **Zero Overhead:** Ideal for projects that only require specific ICU subsets.
+* **No Heavy Linking:** Avoid the headache of compiling and linking against the full ICU library.
+* **Portable Results:** Your program receives a clean, ready-to-use binary map.
+
+### Use Case
+Unicode currently is THE way of handling text right now. However, some applications also require small amounts of information from the text, like "is this char a letter?".
+
+If your project handles Unicode as an **afterthought**, we’re your guy. Get the data you need without the bloat.
+
+---

py-gen.ipynb

@@ -0,0 +1,42 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "4502a404",
+   "metadata": {},
+   "source": [
+    "# x-icu\n",
+    "> **The lightweight bridge to ICU data.**"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "2baaf74f",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.14.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

x-icu.code-workspace

@@ -0,0 +1,8 @@
+{
+	"folders": [
+		{
+			"path": "."
+		}
+	],
+	"settings": {}
+}