Unleash · thomasheartman · Oct 19, 2022 · Sep 27, 2022 · Sep 27, 2022 · Sep 27, 2022
diff --git a/docs/api/oas/openapi.yaml b/docs/api/oas/openapi.yaml
diff --git a/frontend/README.md b/frontend/README.md
@@ -13,14 +13,14 @@ yarn install
 yarn run start
 ```
 
-## Run with a heroku-hosted instance of unleash-api
+## Run with a sandbox instance of the Unleash API
 
-Alternatively, instead of running unleash-api on localhost, use a remote instance:
+Alternatively, instead of running unleash-api on localhost, you can use a remote instance:
 
 ```
 cd ~/frontend
 yarn install
-yarn run start:heroku
+yarn run start:sandbox
 ```
 
 ## Running end-to-end tests
@@ -30,7 +30,7 @@ so it's important that you check these yourself before submitting a PR.
 On the server the tests will run against the deployed Heroku app so this is what you probably want to test against:
 
 ```
-yarn run start:heroku
+yarn run start:sandbox
 ```
 
 In a different shell, you can run the tests themselves:

diff --git a/frontend/package.json b/frontend/package.json
@@ -13,7 +13,7 @@
     "build": "vite build",
     "lint": "yarn fmt:check",
     "start": "vite",
-    "start:heroku": "UNLEASH_API=https://unleash.herokuapp.com yarn run start",
+    "start:sandbox": "UNLEASH_API=https://sandbox.getunleash.io/ospro yarn run start",
     "start:enterprise": "UNLEASH_API=https://unleash4.herokuapp.com yarn run start",
     "start:demo": "UNLEASH_BASE_PATH=/demo/ yarn start",
     "test": "tsc && vitest run",

@@ -63,7 +63,7 @@ Example with curl:
 ```sh
 curl -X GET -H "Content-Type: application/json" \
   -H "Authorization: Basic YWRtaW46" \
-  http://unleash.herokuapp.com/api/admin/state/export?&featureToggles=1&strategies=0 > export.json
+  https://unleash.example.com/api/admin/state/export?&featureToggles=1&strategies=0 > export.json
 ```
 
 ### API Import {#api-import}

@@ -47,8 +47,6 @@ Examples of custom authentication hooks:
 - [basic-auth-hook.js](https://github.com/Unleash/unleash-examples/blob/7ed25f97a31dfd8f773c00847080b1a4c889fd87/v3/securing-basic-auth/basic-auth-hook.js)
 - [keycloak-auth-hook.js](https://github.com/Unleash/unleash-examples/blob/7ed25f97a31dfd8f773c00847080b1a4c889fd87/v3/securing-keycloak-auth/keycloak-auth-hook.js)
 
-We also have a version of Unleash deployed on Heroku which uses Google OAuth 2.0: https://secure-unleash.herokuapp.com
-
 ## Securing the Client API {#securing-the-client-api}
 
 A common way to support client access is to use pre-shared secrets. This can be solved by having clients send a shared key in an HTTP header with every client request to the Unleash API. All official Unleash clients should support this.

@@ -65,7 +65,7 @@ The steps to implement a custom strategy for your client depend on the kind of c
    }
 
    const instance = initialize({
-     url: 'http://unleash.herokuapp.com/api/',
+     url: 'https://unleash.example.com/api/',
      appName: 'unleash-demo',
      instanceId: '1',
      // highlight-next-line

@@ -32,7 +32,7 @@ func init() {
 	unleash.Initialize(
 		unleash.WithListener(&unleash.DebugListener{}),
 		unleash.WithAppName("my-application"),
-		unleash.WithUrl("http://unleash.herokuapp.com/api/"),
+		unleash.WithUrl("https://unleash.example.com/api/"),
         unleash.WithCustomHeaders(http.Header{"Authorization": {"<API token>"}}),
 	)
 }

@@ -111,7 +111,7 @@ UnleashContextProvider contextProvider = new MyAwesomeContextProvider();
 UnleashConfig config = new UnleashConfig.Builder()
             .appName("java-test")
             .instanceId("instance x")
-            .unleashAPI("http://unleash.herokuapp.com/api/")
+            .unleashAPI("https://unleash.example.com/api/")
             .unleashContextProvider(contextProvider)
             .build();
 

@@ -90,7 +90,7 @@ $contextProvider = new MyAwesomeContextProvider();
 $unleash = UnleashBuilder::create()
     ->withAppName('my.php-app')
     ->withInstanceId('your-instance-1')
-    ->withAppUrl('http://unleash.herokuapp.com/api/')
+    ->withAppUrl('https://unleash.example.com/api/')
     ->withContextProvider($contextProvider)
     ->build();
 

@@ -62,7 +62,7 @@ The reference docs are organized into the following topics:
 
 ## Other resources and communities
 
-💻 The core of Unleash is all open source and [hosted on GitHub](https://www.heroku.com/deploy/?template=https://github.com/Unleash/unleash 'Unleash on GitHub').
+💻 The core of Unleash is all open source and [hosted on GitHub](https://github.com/Unleash/unleash/ 'Unleash on GitHub').
 
 💬 If you've got questions or just wanna chat to the team and other Unleash users, come [join our Slack community](https://slack.unleash.run/)
 

@@ -115,21 +115,29 @@ Now you can fetch the feature toggle you created and try turning it on / off in
 
 If you want to set up your own instance for testing purposes you can easily do so by using one of our premade setup kits for Heroku or DigitalOcean.
 
-> The Heroku instance setup is FREE, and includes a DB to save your state but it will eventually go to sleep when not used. The DigitalOcean setup utilises droplets and will cost you around $10/month to run, but in turn it will not go to sleep. NOTE: If you use the DigitalOcean link below and are a new user, you will receive $100 in FREE credits.
+::: info Pricing
 
-### Deploy a free version of Unleash to Heroku
+Both DigitalOcean and Heroku will charge you for running Unleash on their services. However, if you use the DigitalOcean link below and are a new user, you will receive $100 in free credits.
+
+:::
+
+### Deploy a paid version of Unleash to Heroku
 
 [![Deploy to Heroku](https://www.herokucdn.com/deploy/button.png)](https://www.heroku.com/deploy/?template=https://github.com/Unleash/unleash)
 
 ### Deploy a paid version of Unleash to DigitalOcean
 
-> You'll receive $100 in free credits if you are a new DigitalOcean user using this link.
+:::tip Free credits
+
+You'll receive $100 in free credits if you are a new DigitalOcean user using this link.
+
+:::
 
 [![Deploy to DigitalOcean](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/apps/new?repo=https://github.com/Unleash/unleash/tree/main&refcode=0e1d75187044)
 
 ### Accessing your new instance
 
-Once you have set up the new instance, click the URL provided by either Heroku or DigitalOcean and you'll be taken to the application login screen.
+Once you have set up the new instance, follow the URL provided by either Heroku or DigitalOcean and it will take you to the application login screen.
 
 Input the following credentials to log in:
 

@@ -13,7 +13,6 @@ Before you can connect your application to Unleash you need a Unleash server. Yo
 1. **Unleash Open-source**
    - [Docker](../deploy/getting-started.md)
    - [Helm Chart](https://github.com/unleash/helm-charts/)
-   - [Click-to-deploy on Heroku](https://www.heroku.com/deploy/?template=https://github.com/Unleash/unleash)
    - [GitLab](https://docs.gitlab.com/ee/operations/feature_flags.html#choose-a-client-library)
 2. **Unleash Enterprise**
    - [Hosted Plans](https://www.getunleash.io/plans)

@@ -185,6 +185,10 @@ module.exports = {
                         from: '/advanced/audit_log',
                         to: '/reference/event-log',
                     },
+                    {
+                        from: '/api/open_api',
+                        to: '/reference/api/unleash',
+                    },
                 ],
                 createRedirects: function (toPath) {
                     if (