Developers

Take the whole build folder.

Start from the complete public Pages build: the widget, Functions, source mirrors, migrations, and docs in one portable package.

The current codebase contains three levels: the verified SoulWall gate, a bypassable SoulWall Interstitial, and SoulWall Lite charity advertising.

Download SoulWall build Create a charity ad banner

Unlimited integrations and community-driven updates forever. Because this project belongs to humans.

Current public build The public project includes the verified gate, provider integrations, ledger, Interstitial compatibility route, and the SoulWall Lite generator. Download SoulWall build

Self Hosted Build Folder

Use the real pieces

/widget Embeddable browser client. /functions/api Cloudflare Pages API source mirrors. /docs Supabase ledger and provider migrations. /site Public demo HTML, CSS, and browser logic. /lite Hosted light-mode gate for Worker redirects.
Self-hosted source mirror.

Browse the public source mirrors on the site, download the build folder, wire your own credentials, and ship the parts that serve your community.

Secrets are not included.

The public build excludes real environment values, local Wrangler state, and dependency folders. Bring your own Supabase, Cloudflare, and provider keys.

SoulWall Interstitial

A softer charity prompt for readers, articles, and low-friction traffic.

01 Use it when the full gate is too heavy.

SoulWall Interstitial is built for articles, downloads, newsletter links, campaign pages, and casual publisher traffic where the user should be nudged toward good, not blocked behind a hard workflow.

02 Redirect into the hosted Interstitial.

Your Cloudflare Worker sends selected requests to https://soulwall.org/interstitial. The original /lite route remains available for existing installations.

03 Keep the reader moving.

Visitors can choose a verified cause or continue without donating. That makes it suitable for public content where goodwill matters more than locking the door.

title The page, article, or asset name shown in the Lite gate.
next The URL SoulWall sends the visitor back to after the gate.
sourceLabel Your publication, product, or property name.
sourceWebsite Your site origin, used for attribution and click reporting.

Quick Start

Run it like a Pages app

  1. Download the public build.
  2. Install dependencies with npm install.
  3. Create your own .dev.vars from .dev.vars.example, including the optional ledger-credit fields if you want homepage attribution.
  4. Run npm run dev to test Cloudflare Pages Functions locally.
npm install
npm run dev
<script src="https://soulwall.org/widget/soulwall-widget.js"
  data-soulwall-client="your-project"
  data-soulwall-provider="giveth"
  data-soulwall-title="Premium Research Access"
  data-soulwall-description="Unlocks the members-only dashboard for 24 hours."
  data-soulwall-website="https://example.com"></script>

If you include the title, description, and website fields, SoulWall credits your deployment on the master homepage ledger when donations are confirmed.

SoulWall Lite

Generate a verified charity ad placement

  1. Open the generator on the SoulWall homepage.
  2. Enter the publisher name, website URL, and ad-space dimensions.
  3. Paste the generated placement and script into the publisher page.
  4. SoulWall rechecks Giveth approval, rotates current projects, and records viewable impressions and project visits.
<div class="soulwall-lite-placement"
  data-soulwall-placement="swl_your_placement"
  data-soulwall-site="Your Publication"
  data-soulwall-url="https://example.com"
  data-soulwall-width="300"
  data-soulwall-height="250"></div>
<script async src="https://soulwall.org/light/embed.js"></script>

The embed contains no personal profiling. SoulWall counts viewable impressions and visits by placement, publisher, and verified Giveth project.

Take it, use it, make it better, make it work in ways I couldn't have imagined. Godspeed. Go confidently in the direction of your dreams.