Change all occurrences of previous sandbox/prod distinction to reflect our new model (#251)

## Description
Documentation should now be up to date with our new changes made to room
manager as well as web-client-sdk

---------

Co-authored-by: adrian <33912477+czerwiukk@users.noreply.github.com>

Author: Magmusacy

docs/examples/react-native.mdx

@@ -8,7 +8,7 @@ sidebar_position: 0
 _Runnable reference apps demonstrating common Fishjam use cases in React Native_
 
 Each example is a standalone Expo application you can run locally and use as a starting point for your own project.
-All examples use `@fishjam-cloud/react-native-client` and require a Fishjam ID from the [Fishjam Dashboard](https://fishjam.io/app).
+All examples use `@fishjam-cloud/react-native-client`. You need a Fishjam ID to connect to the media server, and a Sandbox API URL to create rooms and get peer tokens. Get your Fishjam ID from the [Fishjam Dashboard](https://fishjam.io/app), and your Sandbox API URL from the [Sandbox tab](https://fishjam.io/app/sandbox). See [What is the Sandbox API?](../explanation/sandbox-api-concept) for an in-depth explanation.
 
 | Example                                   | What it demonstrates                                                  |
 | ----------------------------------------- | --------------------------------------------------------------------- |

docs/examples/react.mdx

@@ -8,7 +8,7 @@ sidebar_position: 1
 _Runnable reference apps demonstrating common Fishjam use cases in React_
 
 Each example is a standalone React application you can run locally and use as a starting point for your own project.
-All examples use `@fishjam-cloud/react-client` and require a Fishjam ID from the [Fishjam Dashboard](https://fishjam.io/app).
+All examples use `@fishjam-cloud/react-client`. You need a Fishjam ID to connect to the media server, and a Sandbox API URL to create rooms and get peer tokens. Get your Fishjam ID from the [Fishjam Dashboard](https://fishjam.io/app), and your Sandbox API URL from the [Sandbox tab](https://fishjam.io/app/sandbox). See [What is the Sandbox API?](../explanation/sandbox-api-concept) for an in-depth explanation.
 
 | Example                             | What it demonstrates                                                    |
 | ----------------------------------- | ----------------------------------------------------------------------- |

docs/explanation/glossary.md

@@ -36,4 +36,4 @@ The ID of your Fishjam instance. It is used by your backend server to add peers
 
 ### Sandbox API
 
-A simple testing API allowing you to test Fishjam features without requiring you to add any functionalities to your backend. As the name suggests, it's available **only** in the Sandbox environment. You can find more details [here](/how-to/backend/sandbox-api-testing).
+A simple testing API allowing you to test Fishjam features without requiring you to add any functionalities to your backend. It is intended for development and testing only, not for production use. You can find more details [here](/how-to/backend/sandbox-api-testing).

docs/explanation/sandbox-api-concept.mdx

@@ -10,14 +10,27 @@ The Sandbox API is a development tool that simplifies getting started with Fishj
 
 ## What can the Sandbox API do?
 
-The Sandbox API is an HTTP server that comes with Fishjam's Sandbox environment.
+The Sandbox API is an HTTP server provided by us for development and testing.
 It provides basic room creation and peer management functionality without requiring you to set up your own backend infrastructure.
 
 ### Key Characteristics
 
 - **Development-purposed**: Designed for initial development and testing
 - **No authentication**: Simplified access for quick prototyping
-- **Sandbox-only**: Only available in the Sandbox environment
+- **Testing-only**: Not intended for production use; use your own authenticated backend for production
+
+## Sandbox API URL and Fishjam ID
+
+You can find your sandbox credentials in the [Sandbox tab](https://fishjam.io/app/sandbox) of the Fishjam Dashboard.
+
+The **Sandbox API** is a hosted HTTP backend you can use to test Fishjam without writing your own server. It creates [**rooms**](../explanation/rooms) and **peers** for conferencing, and supports [**livestreaming**](../explanation/livestreams) by issuing the streamer and viewer credentials. It's an example implementation of what you need to build using our [**JavaScript server SDK**](../api/server) to go to production.
+
+You can use your sandbox credentials by passing them to the `useSandbox` hook in the client SDK, which will create rooms and peer tokens for you, or by calling the Sandbox API URL directly from your client and using the returned `peerToken` to connect to Fishjam.
+
+The **Fishjam ID** from the [Dashboard tab](https://fishjam.io/app) is passed to `FishjamProvider` so the client can connect to the Fishjam media server after it gets a peer token.
+
+If your Sandbox API URL is exposed or your credentials are compromised, generate a new URL from the Sandbox tab to invalidate the old one. You can also disable the Sandbox API and enable it again when you want to resume sandbox testing.
+If you expose your Sandbox API URL in a public deployment, it can leak (for example through client code or network requests). Anyone who obtains that URL can create rooms and peers on your behalf.
 
 ## The Problem Sandbox API Solves
 

docs/explanation/security-tokens.mdx

@@ -29,7 +29,6 @@ Management tokens provide your backend server with administrative access to Fish
 - **Long-lived**: Management tokens remain valid until manually regenerated
 - **High privilege**: Management tokens allow performing administrative operations and should only be used in backend applications.
 - **Backend-only**: Management tokens should never be sent to client applications.
-- **Environment-specific**: There are different tokens for sandbox and production.
 
 ### What Management Tokens Can Do
 

docs/how-to/backend/production-deployment.mdx

@@ -3,8 +3,8 @@ type: how-to
 description: Deploy your Fishjam backend safely to production, moving from sandbox to a production-ready setup.
 ---
 
-import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
+import Tabs from "@theme/Tabs";
 
 # How to Deploy Fishjam to Production
 
@@ -15,27 +15,29 @@ This guide covers the essential steps to move from development (using the Sandbo
 ## Prerequisites
 
 - Working Fishjam backend (see [Backend Quick Start](../../tutorials/backend-quick-start))
-- Production Fishjam environment (not Sandbox)
+- A Fishjam account on the **Standard Jar** plan (recommended for production deployments)
 - Domain and SSL certificates for your backend
 - Production database and infrastructure
 
-## Step 1: Set up production Fishjam environment
+## Step 1: Get your Fishjam credentials
 
-### Get production credentials
+### Get credentials from the dashboard
 
 1. Log in to [Fishjam Dashboard](https://fishjam.io/app)
-2. Create or select your **Production** environment (not Sandbox)
-3. Copy your production **Fishjam ID** and **Management Token**
-4. Note: These are different from your sandbox credentials
+2. Copy your **Fishjam ID** and **Management Token** from the dashboard
+
+:::tip
+The **Standard Jar** plan is recommended for production deployments. With the **Mini Jar** plan, you can still develop and test using the Sandbox API, but production deployments should use the Standard Jar plan to get full access and reliability guarantees.
+:::
 
 ### Environment variables setup
 
-Create production environment variables:
+Create your environment variables:
 
 ```bash
-# Production Fishjam credentials
-FISHJAM_ID="your-production-fishjam-id"
-FISHJAM_MANAGEMENT_TOKEN="your-production-management-token"
+# Fishjam credentials
+FISHJAM_ID="your-fishjam-id"
+FISHJAM_MANAGEMENT_TOKEN="your-management-token"
 
 # Your application settings
 NODE_ENV="production"
@@ -47,7 +49,7 @@ JWT_SECRET="your-secure-jwt-secret"
 CORS_ORIGIN="https://yourdomain.com"
 ```
 
-## Step 2: Implement proper authentication
+## Step 2: Replace Sandbox API with proper authentication
 
 ### Replace Sandbox API calls
 
@@ -61,7 +63,8 @@ import express from "express";
 const authenticateUser = {} as any;
 const app = express();
 
-const { getSandboxPeerToken } = useSandbox();
+const sandboxApiUrl = "your-sandbox-api-url-here";
+const { getSandboxPeerToken } = useSandbox({ sandboxApiUrl });
 
 const userToken = "";
 const roomName = "";

docs/how-to/backend/sandbox-api-testing.mdx

@@ -3,8 +3,8 @@ sidebar_position: 5
 description: Use the Sandbox API to create rooms and peers for testing without setting up your own backend server.
 ---
 
-import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
+import Tabs from "@theme/Tabs";
 
 # Testing with the Sandbox API
 
@@ -13,16 +13,20 @@ The Sandbox API is a development tool that lets you create rooms and peers for t
 ## Prerequisites
 
 - Access to [Fishjam Dashboard](https://fishjam.io/app)
-- A Sandbox environment set up
 
-## Step 1: Get your Fishjam ID
+## Step 1: Get your Fishjam ID and Sandbox API URL
 
 1. Log in to [Fishjam Dashboard](https://fishjam.io/app)
-2. Navigate to your [Sandbox Environment](https://fishjam.io/app/sandbox)
+2. Navigate to the [Sandbox tab](https://fishjam.io/app/sandbox)
 3. Copy your **Fishjam ID**
+4. In the **Sandbox API** section, copy your **Sandbox API URL**
 
 :::note
-`FISHJAM_ID` is your unique sandbox identifier. Anyone who knows this ID can join your rooms, so keep it secure during development.
+You need both values for React/React Native apps:
+
+- `Sandbox API url` is used to call the Sandbox API to create test rooms and return peer tokens.
+- `Fishjam ID` is passed to `FishjamProvider` so the client can connect to the Fishjam media server after it gets a peer token.
+
 :::
 
 ## Step 2: Create a room and get peer tokens
@@ -41,8 +45,8 @@ The Sandbox API is a development tool that lets you create rooms and peers for t
 
     // ...
 
-    // fishjamId is provided through FishjamProvider
-    const { getSandboxPeerToken } = useSandbox();
+    const SANDBOX_API_URL = "your-sandbox-api-url-here";
+    const { getSandboxPeerToken } = useSandbox({ sandboxApiUrl: SANDBOX_API_URL });
     const peerToken = await getSandboxPeerToken(roomName, peerName);
     ```
 
@@ -51,15 +55,15 @@ The Sandbox API is a development tool that lets you create rooms and peers for t
   <TabItem value="react" label="React">
 
     ```ts
-    const FISHJAM_ID = "...";
     const roomName = "testRoom";
     const peerName = "testUser";
     // ---cut---
     import { useSandbox } from '@fishjam-cloud/react-client';
 
     // ...
 
-    const { getSandboxPeerToken } = useSandbox();
+    const SANDBOX_API_URL = "your-sandbox-api-url-here";
+    const { getSandboxPeerToken } = useSandbox({ sandboxApiUrl: SANDBOX_API_URL });
     const peerToken = await getSandboxPeerToken(roomName, peerName);
     ```
 
@@ -78,7 +82,7 @@ The Sandbox API is a development tool that lets you create rooms and peers for t
 ### Room types available
 
 - `conference` - For video/audio conferencing (default)
-- `audio-only` - For audio-only conferencing
+- `audio_only` - For audio-only conferencing
 - `livestream` - For one-to-many video/audio streaming
 
 ## Step 3: Handle the response
@@ -88,7 +92,6 @@ The Sandbox API returns a JSON response with connection details:
 ```json
 {
   "peerToken": "<PEER_TOKEN>",
-  "url": "wss://fishjam.io/api/v1/connect/${YOUR_APP_UUID}",
   "room": {
     "id": "<ROOM_ID>",
     "name": "foo"
@@ -114,6 +117,7 @@ Below are examples on how to use tokens from the Sandbox API in your frontend ap
     const roomName = "testRoom";
     const peerName = `user_${Date.now()}`;
     const FISHJAM_ID = "...";
+    const SANDBOX_API_URL = "...";
 
     const RoomView = (props: {peerToken: string}) => null;
     // ---cut---
@@ -122,7 +126,7 @@ Below are examples on how to use tokens from the Sandbox API in your frontend ap
     export default function TestScreen() {
       const [peerToken, setPeerToken] = useState<string | null>(null);
       // fishjamId is provided through FishjamProvider
-      const { getSandboxPeerToken } = useSandbox();
+      const { getSandboxPeerToken } = useSandbox({ sandboxApiUrl: SANDBOX_API_URL });
 
       useEffect(() => {
         const fetchPeerToken = async () => {
@@ -154,13 +158,14 @@ Below are examples on how to use tokens from the Sandbox API in your frontend ap
     ```tsx
     import React, { useState, useEffect } from "react";
 
-    const FISHJAM_ID = "your-app-uuid-here";
+    const FISHJAM_ID = "your-fishjam-id-here";
+    const SANDBOX_API_URL = "your-sandbox-api-url-here";
     // ---cut---
     import { FishjamProvider, useConnection, useSandbox } from "@fishjam-cloud/react-client";
 
     function VideoCallComponent() {
       const { joinRoom, peerStatus } = useConnection();
-      const { getSandboxPeerToken } = useSandbox();
+      const { getSandboxPeerToken } = useSandbox({ sandboxApiUrl: SANDBOX_API_URL });
 
       const handleJoinRoom = async () => {
         const roomName = "testRoom";
@@ -201,9 +206,10 @@ Below are examples on how to use tokens from the Sandbox API in your frontend ap
 
 ```ts
 import { useSandbox } from "@fishjam-cloud/react-client";
-const { getSandboxPeerToken } = useSandbox();
+const SANDBOX_API_URL = "your-sandbox-api-url-here";
+const { getSandboxPeerToken } = useSandbox({ sandboxApiUrl: SANDBOX_API_URL });
 // ---cut---
-const audioOnlyUrl = await getSandboxPeerToken(
+const audioOnlyPeerToken = await getSandboxPeerToken(
   "audioTest",
   "user1",
   "audio_only",
@@ -214,15 +220,18 @@ const audioOnlyUrl = await getSandboxPeerToken(
 
 ```ts
 import { useSandbox } from "@fishjam-cloud/react-client";
-const { getSandboxLivestream, getSandboxViewerToken } = useSandbox();
+const SANDBOX_API_URL = "your-sandbox-api-url-here";
+const { getSandboxLivestream, getSandboxViewerToken } = useSandbox({
+  sandboxApiUrl: SANDBOX_API_URL,
+});
 // ---cut---
 
 const livestreamName = "livestream1";
 // For the streamer
-const streamerUrl = await getSandboxLivestream(livestreamName);
+const streamerData = await getSandboxLivestream(livestreamName);
 
 // For viewers, you need a viewer token (different endpoint)
-const viewerTokenUrl = await getSandboxViewerToken(livestreamName);
+const viewerToken = await getSandboxViewerToken(livestreamName);
 ```
 
 ## Step 6: Handle multiple peers
@@ -231,7 +240,8 @@ To test with multiple participants, create multiple peer tokens with different p
 
 ```ts
 import { useSandbox } from "@fishjam-cloud/react-client";
-const { getSandboxPeerToken } = useSandbox();
+const SANDBOX_API_URL = "your-sandbox-api-url-here";
+const { getSandboxPeerToken } = useSandbox({ sandboxApiUrl: SANDBOX_API_URL });
 // ---cut---
 // First peer
 const peer1Response = await getSandboxPeerToken("multiTest", "alice");
@@ -278,37 +288,36 @@ const roomName = `livestream-demo`;
 
 ### Issue: Connection failures
 
-**Problem**: Invalid Fishjam ID or network issues.
+**Problem**: Invalid Fishjam ID, invalid Sandbox API URL, disabled Sandbox API, or network issues.
 
 **Solution**:
 
-1. Verify your Fishjam ID in the Fishjam Dashboard
-2. Check network connectivity
-3. Ensure you're using the sandbox environment
+1. Verify your Fishjam ID in the Fishjam Dashboard.
+2. Verify your Sandbox API URL in the [Sandbox tab](https://fishjam.io/app/sandbox).
+3. Make sure the Sandbox API is enabled.
+4. Check network connectivity.
 
 ## Security reminder
 
 :::danger
 **The Sandbox API is not safe for production!**
 
 - No authentication required
-- Anyone with your Fishjam ID can join rooms
+- Anyone with your Sandbox API URL can create rooms and peer tokens
 - Identical room/peer names get the same tokens
 - No rate limiting or abuse protection
 
 Only use the Sandbox API for development and testing.
 :::
 
-## Resetting your app
-
-If you need to reset your Sandbox API:
+## Managing your Sandbox API
 
-1. Go to [Fishjam Dashboard](https://fishjam.io/app/sandbox)
-2. Click **Settings**
-3. Click **Reset App**
-4. Get your new Fishjam ID
+Manage the Sandbox API from the [Sandbox tab](https://fishjam.io/app/sandbox):
 
-This will invalidate all existing tokens (including the management token!) and give you a fresh sandbox environment.
+- If your Sandbox API URL is exposed or credentials are compromised, click **Generate new URL**. This invalidates the old URL.
+- If you want to stop using it, click **Disable Sandbox API**.
+- When you want to use it again, click **Enable Sandbox API**.
+  Your `FISHJAM_ID` is still required by `FishjamProvider` to connect to the Fishjam media server. The Sandbox API URL is only used to request test room and peer tokens.
 
 ## Next steps