diff --git a/README b/README
deleted file mode 100644
index f6183f29adda4f3a29181bab0e30539a90c8ec3f..0000000000000000000000000000000000000000
--- a/README
+++ /dev/null
@@ -1,31 +0,0 @@
-# Bevy 2D Template
-
-## Usage
-
-Write some code, ya dig?
-
-This project is set up for a multi-crate bevy game, but will work equally well
-if just using a single crate for your game. `game_core` is the location of your
-entry point, assets are placed at the root of the workspace in the `assets` folder.
-
-Update the splash screen by replacing `assets/splash.png` - it is scaled by 
-default to fill the shortest screen side; you can include empty space in your 
-splash image as a simple way of changing the padding.
-
-## Commands
-
-- Linux:
-  - Run `make x11-setup` or `make wayland-setup` depending on the target platform
-  - Run `make run` to play
-  - Run `make check` to run Cargo Check
-
-- Web:
-  - Run `make cargo-deps` to install wasm tools
-  - Run `make run-web` to launch the dev server
-  - Run `make check` to run Cargo Check
-  - Run `make web` to build the release version of the web project
-
-## Includes
-
-- Workspace configuration w/ assets dir
-- Splash screen
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..44b0e0ffb59d4e56830462582805edbb96e4fc1e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+# Bevy 2D Template
+
+## Usage
+
+Write some code, ya dig?
+
+This project is set up for a multi-crate bevy game, but will work equally well
+if just using a single crate for your game. `game_core` is the location of your
+entry point, assets are placed at the root of the workspace in the `assets` folder.
+
+Update the splash screen by replacing `assets/splash.png` - it is scaled by 
+default to fill the shortest screen side; you can include empty space in your 
+splash image as a simple way of changing the padding. `assets/splash_sting.mp3` will
+be played during the splash screen.
+
+If you need to pre-process files to generate your assets, update the `Makefile` `assets`
+command so that Gitlab CI will package them properly.
+
+Includes websocket based multiplayer building blocks, using [micro_bevy_remote_events](https://lab.lcr.gr/microhacks/micro-bevy-remote-events)
+
+Comes with a Gitlab CI configuration that will build releases for web, Windows and Linux.
+It will also publish a Gitlab pages site with the web version automatically.
+
+## Commands
+
+This project uses a Makefile to define some commands to get things going.
+
+To run the game locally on linux, get things set up by running `make setup-x11` or `make setup-wayland`
+depending on your requirements.
+
+`make run` will run the desktop version of the game, while `make run-web` will run the game in your web 
+browser. The web version requires `trunk` to be installed (`cargo install trunk`).
+
+Building the game for desktop will use a docker container to manage dependancies, but will mount
+your workspace to perform the build. `make build-linux` and `make build-windows` can be run on any platform
+with docker installed, perfect for cross-compilation without juggling dependencies. `make build-web`
+
+## Includes
+
+- Workspace configuration w/ assets dir
+- Splash screen
+- Websockets
+- High level audio player
\ No newline at end of file