List your space
Put a space you built on Velven in about 5 minutes. It stays where it is hosted; Velven plays it in a frame, records a clip for its tile, and counts its plays.
Deploy it on a supported host
Velven lists spaces on ChatGPT, Vercel, Netlify, GitHub Pages, Cloudflare and Replit. The page must be public, and must let Velven show it in a frame, which all 6 hosts allow by default.
Hosting and proof has the detail for each host.
Paste the URL
Open Add a space, paste the URL and press Fetch. Velven checks the host, that the page answers, and that it can be framed, then shows a card with the page's title and picture.
Sign in and fill in the details
Sign in with GitHub, Google or an email link, and pick a handle if this is your first time. The details form opens, filled in from the page where Velven could read it.
- Title, Type of space and Works on are required.
- One line, Engine, Model, Tool, Prompt and Repo are optional, and tell players what the space is and how it was made.
Prove it is yours
Add this tag to your page's <head>, with your own handle, and deploy again:
<meta name="velven" content="@handle">If the tag is already live, Publish lists the space at once. Otherwise press Save and prove it: the page keeps your details, shows the steps for your host, and checks your site every 20 seconds, publishing as soon as it finds the tag. Press Check now to look straight away.
Note: Your details are kept in this browser for 7 days, so you can close the page and come back after the deploy.
Wait for the clip
Velven plays your space in its own browser and records a 5-second clip; its first frame becomes the thumbnail. This takes a few minutes. Until it lands, only you can see the space, marked Processing, and a strip on its page shows the progress.
Note: To skip the wait, press Add your own clip on the add page before you publish: the space goes live as soon as it is proven. Later, the space's edit page takes a new clip of your own, or up to 2 retakes with a note on what the clip should show.
Or let your agent do it
A coding agent can do all of this for you. On the add page, press Copy instructions for my agent and paste them into its chat, or point it at List a space with an agent. Agents that use skills can install Velven's skills.
Claim a space Velven listed
Velven lists some spaces itself, marked unclaimed and credited to their creator. If one is yours, add the proof tag to it and press Claim it on its page. Its plays stay, and it moves to your handle.
Next steps
- Add sign-in and a leaderboard with the Velven SDK.
- Keep saves so players pick up where they left off.
Put the badge in your README, with your own handle and your space's slug:
<a href="https://velven.ai/handle/slug"><img src="https://velven.ai/badge/slug" alt="On Velven"></a>