Skip to content

Your first day on the workspace

This guide is for data scientists who are new to the workspace. It takes you from your first login to an app that a colleague can open.

1. Log in and start RStudio

Open https://velonde.<your domain> and log in with your company login. The page shows one tile per IDE. Click RStudio, leave the size at Standard, and wait a few seconds for the session to start. The first start also creates your home directory. Only you can access it, and from now on every IDE shows the same home directory. See The IDEs for details.

2. Create a project

Choose File > New Project > New Directory > Velonde project, select the Shiny template and name the project sales. Alternatively, run this in the console:

velonde::new_app("sales", template = "shiny")

This creates an renv project at ~/sales with the template's packages installed, which takes a minute or two. It contains an app.R that runs as it is, a velonde.yaml with the app's settings on the workspace, and a CLAUDE.md that tells the coding agent how the project is laid out. VS Code opens it with File > Open Folder (where projects live). The other templates, for an API, a Quarto report, a dashboard, a pipeline or an MCP server, are listed under New projects.

3. Work on the app

Open app.R and click Run App. Edit the code and run it again. To add a package, run renv::install("ggplot2"). Before you deploy, run renv::snapshot() to record the packages the project uses. Always install packages inside the project this way: a package installed outside a project is not recorded and will be missing on the workspace.

The coding agents know how this workspace works. To start Claude Code, run claude in the terminal. Posit Assistant is the pane in RStudio. The first time, Claude Code asks you to sign in with your Anthropic account, and Posit Assistant with a Posit AI login or an API key (see Accounts). You can ask either of them to add a feature, explain an error or deploy the app, and they run the commands below themselves.

4. Deploy

In the terminal, in the project directory, run:

$ velonde deploy

The workspace builds an image with your packages, pushes it and registers the app. The first build takes a few minutes. Later builds with the same packages take seconds. The last line of the output is the app's address on the apps host, https://apps.velonde.<your domain>/app/sales. Open it. The apps page at https://apps.velonde.<your domain> lists every app you are allowed to see.

If the build fails, the lines above velonde: FAILED give the reason, and When a build fails has the fix for each message. You can also ask the agent to read the output.

5. Share the app

Edit velonde.yaml. Set the title that the apps page shows, a description, and access-groups, the groups from your company login whose members may open the app. To share an app with single people, name them under access-users. If both are empty, everyone on the workspace can open it.

name: sales
title: Sales dashboard
description: Monthly figures by region.
access-groups: [sales]

Run velonde deploy again. The new settings take effect about a minute later. Colleagues in the group open the address with their own login, and the app can tell who they are through velonde::user().

6. Next steps

  • Store a secret. Put a database password into .Renviron in the project. The deploy stores it as the app's secret and never puts it into the image. Alternatively, run velonde env set sales DB_PASSWORD=… in the terminal. See Secrets and environment.
  • Undo a mistake in production. velonde rollback sales restores the previous build for new visitors. velonde history sales lists the last ten builds.
  • Deploy on every merge. velonde git bind ties the app to a branch of your repository. See Deploying from a repository.
  • Refresh data every morning. Write a targets pipeline, or an R or Python script, with a schedule, and an app that reads the pipeline's store. See Pipelines.
  • Send a report every Monday. Give a Quarto or R Markdown report a schedule, or after: its pipeline, and the readers' addresses under email:. See Scheduled reports.
  • Work in Python. Use VS Code or JupyterLab and start a project with velonde new sales --template streamlit (the templates are listed under New projects). uv manages the environment, and velonde deploy publishes a Shiny for Python, Streamlit or Dash app, a FastAPI service, an MCP server, a Quarto report or a notebook. See What deploys.