diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..a547bf3
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
new file mode 100644
index 0000000..bdef820
--- /dev/null
+++ b/.vscode/extensions.json
@@ -0,0 +1,3 @@
+{
+ "recommendations": ["svelte.svelte-vscode"]
+}
diff --git a/README.md b/README.md
index ccdc7d2..617929f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,84 @@
-# Tech-Radar-Editor
+# Tech Radar Editor
+
A web component that allows users to easily create and edit a Tech Radar.
+
+## Who created the Tech Radar?
+
+[ThoughtWorks](https://thoughtworks.com/radar) created the Tech Radar concept, and [Zalando created the visualization](https://opensource.zalando.com/tech-radar/) that is popular today.
+
+## Building the Component
+
+To build the component, you need to have Node.js installed. Clone the repository and run the following commands:
+
+```bash
+pnpm install
+pnpm build
+```
+
+To get it ready to add to NPM or a CDN, run:
+
+```bash
+pnpm build
+pnpm pack
+```
+
+To publish the component to NPM, run:
+
+```bash
+pnpm publish
+```
+
+## Consume the Component in Plain JavaScript
+
+Include the component in an HTML file:
+
+```html
+
+
+
+
+ Tech Radar Editor
+
+
+
+
+
+
+```
+
+## Consume the Component in React
+
+In a React project, you can use the web component as you would use any custom HTML element.
+
+First, ensure that the component is imported or included:
+
+```js
+// index.js
+import React from "react";
+import ReactDOM from "react-dom";
+import "./index.css";
+
+// Import the component
+import "tech-radar-editor";
+
+function App() {
+ return (
+