diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..9acf252
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2024 flo-bit
+
+Permission is hereby granted, free of
+charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
\ No newline at end of file
diff --git a/README.md b/README.md
index 2801b3a..47371f8 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,27 @@
 # bluesky visualizers
 
-collection of visualizations for bluesky, using the bluesky api, tailwind, svelte and pixijs.
+collection of visualizations for bluesky, using the bluesky api, tailwind, svelte, pixijs, three.js and threlte.
 
 [trending hashtags](https://flo-bit.dev/bluesky-visualizers/trending)
-
-<img width="400" alt="trending" src="https://github.com/user-attachments/assets/b980de13-8168-4f5e-b00e-d6331fec3127">
-
 [wordcloud](https://flo-bit.dev/bluesky-visualizers/wordcloud)
+[particles](https://flo-bit.dev/bluesky-visualizers/particles)
+[3d connections](https://flo-bit.dev/bluesky-visualizers/connections-3d)
+[butterflies](https://flo-bit.dev/bluesky-visualizers/butterflies)
+[emotion analysis](https://flo-bit.dev/bluesky-visualizers/emotions)
 
-<img width="1207" alt="wordcloud" src="https://github.com/user-attachments/assets/9e359deb-2c8b-4af6-be2c-b4b34e90f840">
+## run locally
 
-[particles](https://flo-bit.dev/bluesky-visualizers/particles)
+clone repo
+```
+git clone https://github.com/flo-bit/bluesky-visualizers.git
+```
+
+install dependencies
+```
+npm install
+```
 
-<img width="1324" alt="particles" src="https://github.com/user-attachments/assets/c7d2eb68-5ea9-4a7c-9de5-a807d4f7131b">
+run dev server
+```
+npm run dev
+```
diff --git a/package.json b/package.json
index 522d1a1..51abf30 100644
--- a/package.json
+++ b/package.json
@@ -55,5 +55,6 @@
 		"svelte-relative-time": "^0.0.6",
 		"three": "^0.170.0",
 		"uber-noise": "^0.2.2"
-	}
-}
+	},
+	"license": "MIT"
+}
\ No newline at end of file