Adding content to Sandboxes Docs

Lagoja · Lagoja · commit c78777b86ce2 · 2024-09-23T15:31:55.000-07:00
diff --git a/docs/app/docs/cloud/sandboxes/_category_.json b/docs/app/docs/cloud/sandboxes/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Jetify Cloudboxes",
+  "position": 1
+}
diff --git a/docs/app/docs/cloud/sandboxes/faq.md b/docs/app/docs/cloud/sandboxes/faq.md
@@ -0,0 +1,5 @@
+---
+title: FAQ
+sidebar_position: 6
+hide_title: false
+---
diff --git a/docs/app/docs/cloud/sandboxes/link_sandboxes.md b/docs/app/docs/cloud/sandboxes/link_sandboxes.md
@@ -0,0 +1,7 @@
+---
+title: Linking Cloudboxes from your Repo
+sidebar_position: 5
+hide_title: false
+---
+
+You can share Jetify
diff --git a/docs/app/docs/cloud/sandboxes/managing_sandboxes.md b/docs/app/docs/cloud/sandboxes/managing_sandboxes.md
@@ -0,0 +1,30 @@
+---
+title: Managing Cloudboxes
+sidebar_position: 3
+hide_title: false
+---
+Devboxes that you've previously created can be managed from the Jetify Cloudboxes dashboard. From the dashboard, you can start, stop, and delete your previous Cloudboxes.
+
+## Accessing the Cloudboxes Dashboard
+
+To access the Cloudboxes dashboard, navigate to [cloud.jetify.com](https://cloud.jetify.com) and log in with your Jetify account. Once you select an Org, you will can view all the cloudboxes that you have created within that org on the org page.
+
+If you've created any projects in the org, you can also navigate to the project and select the Sandboxes tab to view all the Cloudboxes that you have created for that project.
+
+## Stopping and Starting Cloudboxes
+
+Cloudboxes are automatically stopped after 15 minutes of user inactivity. This is to help you save resources, and avoid being billed for unused Cloudboxes.
+
+If you want to manually stop your Cloudbox, click on the `Options` button on the Cloudbox that you want to stop, and then click on the `Stop` button. Your Cloudboxes package store and project data will be saved, so you can quickly resume your work when you restart the Cloudbox.
+
+:::info
+Stopped Cloudboxes are not billed for CPU usage, but you may be billed for storage usage in excess of the free tier.
+:::
+
+To restart your Cloudbox, click the option button on the cloud box you want to start, and then click the "Start" button. This will launch the Cloudbox with your previous state and packages.
+
+## Deleting Cloudboxes
+
+By default, Cloudboxes are deleted if they are not used for 14 consecutive days. This is to help you save storage costs, and avoid being billed for unused Cloudbox disks.
+
+If you are done with a Cloudbox, you can delete it by clicking on the `Options` button on the Cloudbox that you want to delete, and then clicking on the `Delete` button. This will permanently delete the Cloudbox and the data associated with it.
diff --git a/docs/app/docs/cloud/sandboxes/quickstart.md b/docs/app/docs/cloud/sandboxes/quickstart.md
@@ -0,0 +1,68 @@
+---
+title: Cloudboxes Quickstart
+sidebar_position: 1
+hide_title: false
+---
+
+Jetify Cloudboxes let you spin up reproducible cloud development environments in your browser in seconds. Jetify Cloudboxes are powered by [Devbox](../../index), so you can run your environment on any machine. You can launch any
+
+Let's launch our first Dev Environment with Jetify Cloudboxes.
+
+## Step 1: Launch a Sandbox from Github
+
+You can launch any Github Repo in a Jetify Sandbox by prepend the repo URL with:
+
+```bash
+https://cloud.jetify.com/new/
+```
+
+For example, to launch the [Devbox repo](https://github.com/jetify-com/devbox) in Jetify Cloudboxes, open the following URL in your browser
+
+  [https://cloud.jetify.com/new/github.com/jetify-com/devbox](https://cloud.jetify.com/new/github.com/jetify-com/devbox)
+
+:::tip
+  If you need some inspiration, you can also launch one of our [template](google.com) projects to get started
+:::
+
+You can also launch a new Sandbox by navigating to your [Dashboard](https://cloud.jetify.com/dashboard) and clicking on the `New Sandbox` button.
+
+## Step 2: Customize your Sandbox with Devbox
+
+You can customize your Jetify Sandbox with over 100,000 Nix packages in seconds using Devbox.
+
+If your project doesn't already have a devbox.json, you can initialize one with:
+
+```bash
+devbox init
+```
+
+Once initialized, you can install your packages using:
+
+```bash
+devbox add <package>@<version>
+```
+
+For example, to install `python 3.11`, you can run:
+
+```bash
+devbox add python@3.11
+```
+
+You can find packages to install using `devbox search <package>`, or by searching in your browser with [Nixhub](https://www.nixhub.io)
+
+Packages you install will be added to your `devbox.json` file. You can also use this `devbox.json` file configure your environment with [scripts](../../guides/scripts), [services](../../guides/sevices), and more
+
+**Further Reading**
+* [Devbox Quickstart](../../quickstart)
+* [Devbox CLI Reference](../../cli_reference/devbox)
+
+## Step 3: Save your Dev Environment with `devbox.json`
+
+Once you've customized your environment, you can save your Dev Environment config to source control by checking in your `devbox.json` and `devbox.lock` files. These files can be used to recreate your environment on Jetify Cloudboxes, or on any other machine that has devbox installed.
+
+You can also use this file to configure initilization hooks, scripts, services, and environment variables for your project.
+
+**Further Reading**
+* [Devbox Configuration Reference](../../configuration.md)
+* [Devbox Script](../../guides/scripts)
+* [Devbox Services](../../guide/services)
diff --git a/docs/app/docs/cloud/sandboxes/start_a_sandbox.md b/docs/app/docs/cloud/sandboxes/start_a_sandbox.md
@@ -0,0 +1,11 @@
+---
+title: Starting a Sandbox
+sidebar_position: 2
+hide_title: false
+---
+
+## Stating a Sandbox from Your Dashboard
+
+## Starting a Sandbox from Github
+
+## Starting a Sandbox from a Template
diff --git a/docs/app/docs/cloud/sandboxes/team_sandboxes.md b/docs/app/docs/cloud/sandboxes/team_sandboxes.md
@@ -0,0 +1,5 @@
+---
+title: Using Cloudboxes with your Team
+sidebar_position: 4
+hide_title: false
+---
diff --git a/docs/app/docs/cloud/sidebar.ts b/docs/app/docs/cloud/sidebar.ts
@@ -2,43 +2,51 @@ import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
 
 const cloudSidebar: SidebarsConfig = {
   sidebar: [
+    {
+      type: "doc",
+      id: "cloud/index",
+    },
     {
       type: "category",
-      label: "Managing your Team",
+      label: "Cloudboxes",
+      collapsible: false,
       items: [
         {
           type: "autogenerated",
-          dirName: "cloud/dashboard",
+          dirName: "cloud/sandboxes",
         },
       ],
     },
     {
       type: "category",
-      label: "Caching your Project Packages with Jetify Cache",
+      label: "Secrets",
+      collapsible: false,
       items: [
         {
           type: "autogenerated",
-          dirName: "cloud/cache",
+          dirName: "cloud/secrets",
         },
       ],
     },
     {
       type: "category",
-      label: "Syncing and Managing Secrets with Jetify Secrets",
+      label: "Package Cache",
+      collapsible: false,
       items: [
         {
           type: "autogenerated",
-          dirName: "cloud/secrets",
+          dirName: "cloud/cache",
         },
       ],
     },
     {
       type: "category",
-      label: "Developing with Jetify Cloudboxes",
+      label: "Teams and Projects",
+      collapsible: false,
       items: [
         {
           type: "autogenerated",
-          dirName: "cloud/sandboxes",
+          dirName: "cloud/dashboard",
         },
       ],
     },
diff --git a/docs/app/docs/nixhub/sidebar.ts b/docs/app/docs/nixhub/sidebar.ts
@@ -1,24 +1,23 @@
 import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
 
 const nixhubSidebar: SidebarsConfig = {
-  sidebar:
-    [
-        {
-            type: "doc",
-            label: "Get a Package",
-            id: "nixhub/get-a-package",
-        },
-        {
-            type: "doc",
-            label: "Search Packages",
-            id: "nixhub/search-packages",
-        },
-        {
-          type: "doc",
-          label: "Resolve a Package",
-          id: "nixhub/resolve-a-package-version",
-        }
-    ]
-}
+  sidebar: [
+    {
+      type: "doc",
+      label: "Get a Package",
+      id: "nixhub/get-a-package",
+    },
+    {
+      type: "doc",
+      label: "Search Packages",
+      id: "nixhub/search-packages",
+    },
+    {
+      type: "doc",
+      label: "Resolve a Package",
+      id: "nixhub/resolve-a-package-version",
+    },
+  ],
+};
 
-export default nixhubSidebar.sidebar;
+export default nixhubSidebar.sidebar;
diff --git a/docs/app/sidebars.js b/docs/app/sidebars.js
@@ -208,19 +208,7 @@ const sidebars = {
     },
   ],
 
-  cloudSidebar: [
-    {
-      type: "category",
-      label: "Jetify Cloud",
-      collapsed: false,
-      collapsible: false,
-      link: {
-        type: "doc",
-        id: "cloud/index",
-      },
-      items: require("./docs/cloud/sidebar"),
-    },
-  ],
+  cloudSidebar: require("./docs/cloud/sidebar"),
 };
 
 export default sidebars;

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +{
 +  "label": "Jetify Cloudboxes",
 +  "position": 1
 +}