Install a wall

Every wall goes on a site the same way: one script tag, then one element where the wall should appear. Pick the wall type and where it goes, and copy the code for your site, or hand the prompt to your AI agent.

Wall type

Newest items stacked top to bottom, each sliding in as it arrives. The default, and it fits anywhere.

Script tag

Any site. Paste both lines where the wall should appear, or the script once in <head>.

<script type="module" src="https://vitalwall.com/v1/vitalwall.js"></script>
<vital-wall wall="YOUR_WALL_ID"></vital-wall>

React / Next.js

Install the package, then drop in the component.

npm install @vitalwall/react
import { Wall } from '@vitalwall/react'

<Wall wall="YOUR_WALL_ID" />

Ask your agent

With VitalWall connected to your agent (Claude, Cursor and others), paste this in the site's project. It allows the domain, adds the code and checks the first update arrives.

Add my VitalWall list wall to this site, where the wall should appear. Use the VitalWall MCP tools: add_wall_domain for this site's domain, get_install for this site's framework, apply the steps, and run verify_install once it's published.

Step by step for your platform

  1. 1. Load the script once

    Inside <head>, on every page that shows a wall.

    <script type="module" src="https://vitalwall.com/v1/vitalwall.js"></script>
  2. 2. Add the element

    In the page HTML, where the wall should appear.

    <vital-wall wall="YOUR_WALL_ID"></vital-wall>

The wall only shows on the domains you list for it (localhost always works). Walls take your page's font and colours; set --vw-accent, --vw-radius or --vw-item-bg on the element to theme it.

Send items to the wall

Wrap the button whose clicks should show on the wall, or post from your own code. The API key is on the wall’s settings page. It can sit in page code: it only posts to this one wall.

<!-- Posts an item each time the button is clicked. Leave out on="click" to post once per page view. -->
<vital-track wall="YOUR_WALL_ID" api-key="YOUR_WALL_API_KEY" on="click" item="Someone just added an item to their cart">
  <button>Add to cart</button>
</vital-track>

<!-- Or from your own code, e.g. when an order goes through: -->
<script>
  function onPurchase(product) {
    window.VitalWall.track({ wall: 'YOUR_WALL_ID', key: 'YOUR_WALL_API_KEY', item: 'Someone just bought ' + product })
  }
</script>