diff --git a/README.md b/README.md
index 6889b88..fbda9f4 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,110 @@
-# Velocity
+
-A CLI that allows you to create, update, delete and invoke serverless functions powered by Firecracker.
+
+
-## Why?
+
CLI
-Absolutely no reason. I thought it would be fun to build so i did
+
+ The Velocity CLI allows you to create and run serverless Velocity functions from your terminal.
+
+ Explore the docs ยป
+
+
+
+
-WIP
+## About
+The CLI is written in Go using the Cobra framework and Bubbletea as a TUI. It allows you to create, delete and invoke Velocity functions.
+
+
+
+
+## Getting Started
+
+This section outlines how to install the CLI to get started creating functions.
+
+### Installation
+
+Download the precompiled binary for your operating system on the [release page](https://github.com/runvelocity/cli/releases)
+
+
+
+
+## Usage
+
+### Creating a function
+
+Create a file called function.js and input the following code
+
+```javascript
+module.exports = (args) => {
+ return {
+ hello: "world",
+ }
+}
+```
+
+Next, you have to create a zip file containing this code. If you are on windows with powershell, use the following command
+
+```shell
+Compress-Archive -LiteralPath .\function.js -DestinationPath code.zip
+```
+
+On Linux/Mac, use the following command
+
+```shell
+zip code.zip function.js
+```
+
+Next, create a function by running the following command
+
+```
+.\cli.exe create --name demo-func --file-path code.zip --handler function
+```
+
+### Invoking a function
+
+To invoke a function, run the following command
+
+```shell
+.\cli.exe invoke --name demo-func
+```
+
+
+## Roadmap
+
+- [ ] Add support for updating functions
+- [ ] Pass in parameters from the command line
+
+