diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8d9d265
--- /dev/null
+++ b/README.md
@@ -0,0 +1,75 @@
+<p align="center"><img src="/assets/logo.svg" width="128" height="128"></p>
+ 
+# ReplayWeb.page
+
+## Serverless Web Archive Replay
+
+ReplayWeb.page provides a full web archive replay system running directly in the browser, 
+available at: https://replayweb.page/
+
+For full user docs, see: https://replayweb.page/docs
+
+The ReplayWeb.page App can be downloaded from: https://replayweb.page/releases
+
+
+## Architecture / What's in this repo
+
+ReplayWeb.page is a static web site / offline web app + Electron app.
+
+This repository contains the frontend UI for the replay system, while the backend is provided via a service worker
+implementation found at: https://github.com/webrecorder/wabac.js
+
+The frontend is loaded from `ui.js`, while the backend service/web worker is loaded from `sw.js`.
+
+This repository contains:
+- The built assets for the site hosted at https://replayweb.page/ via GitHub Pages
+- A build system for https://replayweb.page and ReplayWeb.page App.
+- Docs hosted at: https://replayweb.page/docs
+- App releases at: https://github.com/webrecorder/replayweb.page/releases
+
+## How to Use
+
+ReplayWeb.page is built as a Node package can be installed using yarn:
+
+`yarn install`
+
+It is also a Jekyll site for use with GitHub pages. Jekyll is only needed to build the docs.
+
+The package provides various commands that can be used with yarn:
+
+- `yarn run start-dev` - to run in dev mode with Webpack dev server on port 9990. Autobuilds dev assets.
+
+- `yarn run build` - to build production assets sw.js, ui.js
+
+- `yarn run start-prod` - to run production site on port 9990, with previously built assets
+
+- `yarn run start-electron` - to start electron in dev mode, with previously built assets
+
+- `yarn run dist` - to build production assets + Electron app (in dist/)
+
+- `yarn run build-docs` - to build the Jekyll docs (for local use) and run Jekyll. Requires Ruby.
+
+- `yarn run start-jekyll` - to build Jekyll docs and start Jekyll static server on port 4000.
+
+
+The static assets are placed in the root `index.html`, `sw.js` and `ui.js`, and can be used with any HTTP server.
+
+For service workers to work, they must be served from either localhost or an HTTPS endpoint.
+
+## LICENSE
+
+ReplayWeb.page is made available under the AGPLv3 License.
+
+If you would like to use it under a different license, please reach out as that may be a possibility.
+
+
+## Contributing and Bug Reports
+
+Contributions are definitely welcome!
+
+As this is still a new project and rapidly evolving, please open an issue first before submitting a pull request.
+
+
+
+
+