Set up and use Coder

Smart Placement uses Coder to provide an out-of-the-box development environment. This documentation site assumes that any spec writing is done using Coder.

A Coder instance will have been set up for you by Artificial during onboarding. Before writing any code, you must provision a Coder workspace.

Provision a Coder workspace

  1. Navigate to your Coder instance and sign in. By default, this will be at https://coder.artificial.app/workspaces.

  2. Select a template to create a new workspace. A workspace is your personal, customisable development environment.

    1. Enter a name for your workspace.

    2. (Optional) Enter an email to be used for commits. Leave empty to default to your Coder email.

    3. (Optional) Enter a username to be used for commits. Leave empty to default to your full name in Coder.

    4. Select Create Workspace. The workspace then builds and starts.

Work in Coder

To begin working in your Coder workspace:

  1. Navigate to your Coder instance and sign in. By default, this will be at https://coder.artificial.app/workspaces.

  2. Select a workspace.

  3. Select an IDE. The following are currently supported:

    1. VS Code Desktop.

    2. Cursor Desktop. You must run install-extensions in the terminal to install Brossa extensions before use.

    3. VS Code Web.

  4. Connect to your environment:

    1. Navigate to the terminal. For VS Code Web:

      1. Select Settings from the bottom left, then select Command Palette.

      2. Enter Terminal: Create new terminal.

    2. Run the following command, replacing <your-environment> with the name of your environment:

      console -e <your-environment>

      The authentication process is automatically triggered.

      Run the command console for a list of all environments available to you.

  5. Select Open, and complete the authentication process in your browser.

Edit a product

From the IDE, you can pull products from a Smart Placement environment into your workspace, or push changes from your workspace into an environment.

To push or pull changes, from the Command Palette use the Brossa: Push product or Brossa: Pull product commands.