diff --git a/.gitignore b/.gitignore
index 399b460..2e60230 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,3 @@
 CIRCUITPY/settings.toml
+.DS_Store
+.vscode/
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fd2fef0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Balcony Weather Station
+
+A DIY weather station on my balcony that is hooked up to [Home Assistant](https://www.home-assistant.io/).
+
+The code is [CircuitPython](https://circuitpython.org/). It follows many of the patterns I learned in creating an [aquarium controller](https://git.sr.ht/~travisshears/sewa-reef-controller).
+
+## Capabilities 
+
+Right now the station is fairly limited measuring only temperature, humidity,
+and atmospheric pressure. I have plans to expand the project to also measure
+noise levels, and wind.
+
+## Hardware
+
+Sensors:
+- BME280
+
+MCs:
+- Raspberry Pi Pico
+- Adafruit Airlift
+
+## Images
+
+![power case](/docs/power.jpg)
\ No newline at end of file
diff --git a/docs/case.jpg b/docs/case.jpg
new file mode 100644
index 0000000..f252aa1
Binary files /dev/null and b/docs/case.jpg differ
diff --git a/docs/circuit.jpg b/docs/circuit.jpg
new file mode 100644
index 0000000..a49e856
Binary files /dev/null and b/docs/circuit.jpg differ
diff --git a/docs/home_assistant.jpg b/docs/home_assistant.jpg
new file mode 100644
index 0000000..8384592
Binary files /dev/null and b/docs/home_assistant.jpg differ
diff --git a/docs/power.jpg b/docs/power.jpg
new file mode 100644
index 0000000..68b8e56
Binary files /dev/null and b/docs/power.jpg differ