Update Content

Author: Lagoja

docs/app/.envrc

@@ -0,0 +1,7 @@
+# Automatically sets up your devbox environment whenever you cd into this
+# directory via our direnv integration:
+
+eval "$(devbox generate direnv --print-envrc)"
+
+# check out https://www.jetpack.io/devbox/docs/ide_configuration/direnv/
+# for more details

docs/app/cloud/devspace/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "Jetify Cloudboxes",
+  "label": "Jetify Devspace",
   "position": 1
 }

docs/app/cloud/devspace/faq.md

@@ -8,9 +8,9 @@ hide_title: false
 
 Jetify Devspace is a cloud-based development environment that can be customized and preconfigured using Devbox. Your Devspace is fully managed by Jetify, so you don't need to worry about setting up servers or infrastructure to get started.
 
-## What size instances are available for Jetify Sandboxes?
+## What size instances are available for Jetify Devspace?
 
-Currently, all Jetify Sandboxes are configured with the following default specs:
+Currently, all Jetify Devspace are configured with the following default specs:
 
 * 4 vCPUs
 * 16 GB RAM

docs/app/cloud/devspace/index.md

@@ -1 +1,68 @@
+---
+title: Quickstart
+sidebar_position: 1
+hide_title: false
+---
 
+Jetify Devspace let you spin up reproducible cloud development environments in your browser in seconds. Jetify Devspace is powered by [Devbox](/devbox/docs), so you can run your environment on any machine. You can launch any
+
+Let's launch our first Dev Environment in Jetify Devspace.
+
+## Step 1: Launch Jetify Devspace 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), 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 [templates](/devbox/docs/devbox_examples) projects to get started
+:::
+
+You can also launch a new Devspace by navigating to your [Dashboard](https://cloud.jetify.com/dashboard) and clicking on the `New Devspace` button.
+
+## Step 2: Customize your Environment with Devbox
+
+You can customize your Jetify Devspace 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 [email protected]
+```
+
+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](/devbox/docs/guides/scripts), [services](/devbox/docs/guides/services), and more
+
+For further reading on how to install packages with Devbox, see:
+
+* [Devbox Quickstart](/devbox/docs/quickstart)
+* [Devbox CLI Reference](/devbox/docs/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 Devspace, or on any other machine that has devbox installed.
+
+You can also use this file to configure initialization hooks, scripts, services, and environment variables for your project. For further reading, see:
+
+* [Devbox Configuration Reference](/devbox/docs/configuration)
+* [Devbox Script](/devbox/docs/guides/scripts)
+* [Devbox Services](/devbox/docs/guides/services)

docs/app/cloud/devspace/link_sandboxes.md

@@ -1,10 +1,10 @@
 ---
-title: Sharing Config and Secrets with Projects
+title: Sharing Devspace
 sidebar_position: 4
 hide_title: false
 ---
 
-**Jetify Projects** are a great way to share configuration and secrets with your team. A project can store repository settings and secrets that are shared across all Devspace users in the project. For example, you can configure a project for a Backend API with the database parameters, API keys, and other secrets. When a user launches a Sandbox in the project, they will automatically have access to the project's configuration and secrets.
+**Jetify Projects** are a great way to share configuration and secrets with your team. A project can store repository settings and secrets that are shared across all Devspace users in the project. For example, you can configure a project for a Backend API with the database parameters, API keys, and other secrets. When a user launches Jetify Devspace in the project, they will automatically have access to the project's configuration and secrets.
 
 ## Creating a Project
 
@@ -18,9 +18,9 @@ To create a project:
 
 Once the project is linked to a repository, developers can automatically create a new Sandbox for that repository by navigating to the project and clicking on the `New Sandbox` button.
 
-## Sharing Secrets across Sandboxes
+## Sharing Secrets 
 
-Jetify Projects can store secrets with Jetify Secrets that are shared across all Devspaces in the project. New Jetify Devspace instance will automatically use the `dev` namespace when accessing secrets.
+Jetify Projects can store secrets with Jetify Secrets that are shared across all Devspaces in the project. New Jetify Devspace instances will automatically use the `dev` namespace when accessing secrets.
 
 To add a secret to a project:
 

docs/app/cloud/devspace/managing_sandboxes.md renamed to docs/app/cloud/devspace/managing_devspaces.md

@@ -0,0 +1,44 @@
+---
+title: Starting Jetify Devspaces
+sidebar_position: 2
+hide_title: false
+---
+
+## From Your Dashboard
+
+If you have not created a Devspace before, you will need to link your Github Account first in order to grant us permissions to access your repositories. 
+
+1. Navigate to the [Jetify Dashboard](https://cloud.jetify.com/dashboard) and clicking on the "**Connect Github Repository**" button.
+2. After signing in with Github, you will need to give the Jetify Cloud Github App permissions to access and create repositories on your account.
+
+To create a new Jetify Devspace from your [Jetify Dashboard](https://cloud.jetify.com/):
+
+1. Click "**+ Create New**" button on the top right corner of the page.
+2. In the modal that appears, enter the URL of the Github repository you want to use for your Devspace.
+3. Click "**Create Devspace**" to start your new Devspace
+
+![Create New Devspace](/img/dashboard_create_new_devspace.png)
+
+Once you've created a Devspace, you can access it from the Devspace list in your Dashboard.
+
+## With a Github URL
+
+You can start Jetify Devspace from any Github Repo by prepending the repo URL with:
+
+```bash
+https://cloud.jetify.com/new/
+```
+
+For example, you can open the Devbox repo in a Jetify Devspace by opening the following URL in your browser:
+
+```bash
+https://cloud.jetify.com/new/github.com/jetify-com/devbox
+```
+
+## From a Template
+
+A full list of available templates and projects can be found in the [Devbox Examples](/devbox/docs/devbox_examples/) page of our documentation.
+
+## From a Project
+
+If you've already created a project in the Jetify Dashboard, you can start a new Devspace from the project by navigating to the project and clicking on the "**+ Create New**" button. This will create a new Devspace using the project's configuration and secrets.