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:
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:
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.
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
.Renvironin the project. The deploy stores it as the app's secret and never puts it into the image. Alternatively, runvelonde env set sales DB_PASSWORD=…in the terminal. See Secrets and environment. - Undo a mistake in production.
velonde rollback salesrestores the previous build for new visitors.velonde history saleslists the last ten builds. - Deploy on every merge.
velonde git bindties the app to a branch of your repository. See Deploying from a repository. - Refresh data every morning. Write a
targetspipeline, or an R or Python script, with aschedule, 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, orafter:its pipeline, and the readers' addresses underemail:. 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).uvmanages the environment, andvelonde deploypublishes a Shiny for Python, Streamlit or Dash app, a FastAPI service, an MCP server, a Quarto report or a notebook. See What deploys.