diff --git a/.gitignore b/.gitignore
index 4feabaa..d2196e7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,11 @@
-# Initial
+# MakeCode
+built
+node_modules
+yotta_modules
+yotta_targets
+pxt_modules
+_site
+*.db
+*.tgz
+.header.json
+.simstate.json
diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 0000000..f8106d4
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,23 @@
+{
+    "editor.formatOnType": true,
+    "files.autoSave": "afterDelay",
+    "files.watcherExclude": {
+        "**/.git/objects/**": true,
+        "**/built/**": true,
+        "**/node_modules/**": true,
+        "**/yotta_modules/**": true,
+        "**/yotta_targets": true,
+        "**/pxt_modules/**": true
+    },
+    "files.associations": {
+        "*.blocks": "html",
+        "*.jres": "json"
+    },
+    "search.exclude": {
+        "**/built": true,
+        "**/node_modules": true,
+        "**/yotta_modules": true,
+        "**/yotta_targets": true,
+        "**/pxt_modules": true
+    }
+}
\ No newline at end of file
diff --git a/Gemfile b/Gemfile
new file mode 100644
index 0000000..91ceacd
--- /dev/null
+++ b/Gemfile
@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gem 'github-pages', group: :jekyll_plugins
\ No newline at end of file
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..9068464
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,10 @@
+all: deploy
+
+build:
+	pxt build
+
+deploy:
+	pxt deploy
+
+test:
+	pxt test
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3815800
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+
+> Open this page at [https://buzz-lightsnack-2007.github.io/microbit_compass/](https://buzz-lightsnack-2007.github.io/microbit_compass/)
+
+## Use as Extension
+
+This repository can be added as an **extension** in MakeCode.
+
+* open [https://makecode.microbit.org/](https://makecode.microbit.org/)
+* click on **New Project**
+* click on **Extensions** under the gearwheel menu
+* search for **https://github.com/buzz-lightsnack-2007/microbit_compass** and import
+
+## Edit this project ![Build status badge](https://github.com/buzz-lightsnack-2007/microbit_compass/workflows/MakeCode/badge.svg)
+
+To edit this repository in MakeCode.
+
+* open [https://makecode.microbit.org/](https://makecode.microbit.org/)
+* click on **Import** then click on **Import URL**
+* paste **https://github.com/buzz-lightsnack-2007/microbit_compass** and click import
+
+## Blocks preview
+
+This image shows the blocks code from the last commit in master.
+This image may take a few minutes to refresh.
+
+![A rendered view of the blocks](https://github.com/buzz-lightsnack-2007/microbit_compass/raw/master/.github/makecode/blocks.png)
+
+#### Metadata (used for search, rendering)
+
+* for PXT/microbit
+<script src="https://makecode.com/gh-pages-embed.js"></script><script>makeCodeRender("{{ site.makecode.home_url }}", "{{ site.github.owner_name }}/{{ site.github.repository_name }}");</script>
diff --git a/_config.yml b/_config.yml
new file mode 100644
index 0000000..f56a029
--- /dev/null
+++ b/_config.yml
@@ -0,0 +1,8 @@
+makecode:
+  target: microbit
+  platform: microbit
+  home_url: https://makecode.microbit.org/
+theme: jekyll-theme-slate
+include:
+  - assets
+  - README.md
diff --git a/main.blocks b/main.blocks
new file mode 100644
index 0000000..9720ca4
--- /dev/null
+++ b/main.blocks
@@ -0,0 +1,4 @@
+<xml xmlns="http://www.w3.org/1999/xhtml">
+  <block type="pxt-on-start"></block>
+  <block type="device_forever"></block>
+</xml>
\ No newline at end of file
diff --git a/main.ts b/main.ts
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/main.ts
@@ -0,0 +1 @@
+
diff --git a/pxt.json b/pxt.json
new file mode 100644
index 0000000..bcb9150
--- /dev/null
+++ b/pxt.json
@@ -0,0 +1,27 @@
+{
+    "name": "microbit_compass",
+    "version": "0.0.0",
+    "description": "",
+    "dependencies": {
+        "core": "*",
+        "radio": "*",
+        "microphone": "*"
+    },
+    "files": [
+        "README.md",
+        "main.blocks",
+        "main.ts"
+    ],
+    "testFiles": [
+        "test.ts"
+    ],
+    "public": true,
+    "targetVersions": {
+        "target": "5.0.12",
+        "targetId": "microbit"
+    },
+    "supportedTargets": [
+        "microbit"
+    ],
+    "preferredEditor": "blocksprj"
+}
diff --git a/test.ts b/test.ts
new file mode 100644
index 0000000..7bf240c
--- /dev/null
+++ b/test.ts
@@ -0,0 +1 @@
+// tests go here; this will not be compiled when this package is used as an extension.
diff --git a/tsconfig.json b/tsconfig.json
new file mode 100644
index 0000000..46f831b
--- /dev/null
+++ b/tsconfig.json
@@ -0,0 +1,9 @@
+{
+    "compilerOptions": {
+        "target": "ES5",
+        "noImplicitAny": true,
+        "outDir": "built",
+        "rootDir": "."
+    },
+    "exclude": ["pxt_modules/**/*test.ts"]
+}