diff --git a/README.md b/README.md
new file mode 100644
index 000000000..66e473232
--- /dev/null
+++ b/README.md
@@ -0,0 +1,60 @@
+# Curriculum Platform
+
+## What is it?
+
+This is a white label multi-tenant platform for us and our code school friends to use to manage our curricula. It's built on top of [Hugo](https://gohugo.io/) and [Netlify CMS](https://www.netlifycms.org/).
+
+The platform, layout, styles and components are all developed in the Hugo module [/common-theme](/common-theme).
+
+The content is developed in the Hugo module [/common-content](/common-content). This content is all headless blocks. It doesn't create any pages on your site unless you call it somewhere.
+
+Multi-language support is provided by [Hugo's i18n support](https://gohugo.io/content-management/multilingual/).
+
+Each org builds its own Hugo site that uses the common theme and content modules, and then makes any customisations they need and deploys it wherever they want.
+
+## Examples
+
+- [CodeYourFuture](/org-cyf/) => [https://org-cyf-theme.netlify.app/](https://org-cyf-theme.netlify.app/)
+- [MigraCode](/org-mcb/) => [https://org-mcb-theme.netlify.app/](https://org-mcb-theme.netlify.app/) (couldn't find an svg logo)
+
+## To build a new site
+
+1. In the root of this repo, run:
+
+```bash
+hugo new site org-<your-org-name>
+cd org-<your-org-name>
+```
+
+2. Initialise your new site as a hugo module, as only modules can import modules:
+
+```zsh
+hugo mod init github.com/CodeYourFuture/curriculum-labs/org-<your-org-name>
+```
+
+Then add the common theme and content modules as hugo modules to hugo.toml:
+
+```toml
+[module]
+  [[module.imports]]
+    path = "github.com/CodeYourFuture/curriculum-labs/common-theme"
+  [[module.imports]]
+    path = "github.com/CodeYourFuture/curriculum-labs/common-content"
+    [[module.imports.mounts]]
+      source = "en"
+      target = "content"
+```
+
+Look at the [org-cyf](/org-cyf/) and [org-mcb](/org-mcb/) examples for more details and options.
+
+To customise the css, make a dir `assets/custom-theme` and throw any scss in there. It will be compiled and added last.
+
+To add site logo/s, make a dir and add svgs to `assets/custom-images/site-logo/`. They will be added to the site header.
+
+Add your content to `content/` and customise the site config in `config.toml`. Please contribute any improvements you make back to the common theme and content modules.
+
+For each module you import, add a `replace` directive to your `go.mod` file - if you forget to do this, you won't get live updates to your site when shared content changes. CI will remind you if you forget.
+
+## To locally develop your site
+
+`cd` into the site you wish to develop, and run `hugo server` to get a live preview.