Build an App With a Coding Agent

You can make your own ConvexValue app without starting from a blank project.

The ConvexValue scaffold tool creates the starter files for you. Then you open the folder with your favorite coding agent and describe the app you want in plain English.

You can use any coding agent you like, including Codex, Claude Code, or another agent that can read and edit files on your computer.

What You Need

Before you start, install these two tools:

1. Node.js - this lets your computer run the npm command.
2. A coding agent - this is the AI coding assistant you will ask to build the app.

You do not need to understand the files that get created. The point of this flow is to let your coding agent do the technical work after the project is created.

Create the App

Open your terminal and run these commands one line at a time:

npm create convexvalue@latest my-app
cd my-app
npm install
cvx login
codex

What each line does:

npm create convexvalue@latest my-app creates a new ConvexValue app folder called my-app.

cd my-app moves your terminal into that new folder.

cvx login connects the app tools to your ConvexValue account. You only need to do this before publishing or uploading an app.

codex opens Codex inside the app folder so it can edit the app. If you use Claude Code or another coding agent, run that agent's command here instead.

If you prefer npx, this is the same first step:

npx create-convexvalue@latest my-app

Ask Your Coding Agent to Build

After your coding agent opens, tell it what you want the app to do.

For example:

Build me a ConvexValue app that shows SPY options volume and open interest in a clean dashboard.
Make it easy to change the symbol.

Or:

Build me a market calendar app that shows upcoming earnings and economic events.
Use the ConvexValue data tools already available in this project.

Be specific about the outcome, not the code. Your coding agent can inspect the starter project, read the included instructions, and make the changes.

Preview the App

Ask your coding agent:

Run the ConvexValue app locally with live data so I can preview it.

Your coding agent will usually run a command like:

npm run dev:cvx

It will give you a local cvx dev proxy link. Open that proxy link in your browser to see the app with ConvexValue runtime credentials and live data access.

npm run dev:cvx starts your normal Vite development server, creates a localhost proxy, injects the short-lived ConvexValue runtime token, and forwards app data requests like /api/get, /api/data, and /api/ws.

Improve It

You can keep asking your coding agent for changes:

Make the table easier to read.

Add a chart at the top.

Use a darker visual style and make it work well on a laptop screen.

Treat this like working with a designer and developer. Describe what you want, look at the preview, then ask for changes.

Publish It

When the app looks right, ask your coding agent:

Build and upload this ConvexValue app.

The generated project includes the ConvexValue upload tools. Because you already ran cvx login, your coding agent can use those tools to prepare the app and publish it through your ConvexValue account.