Self-hosting on Cloudflare

The site is static files plus Pages Functions. There is no database, no KV and no secret. You need Node 20 or newer and a Cloudflare account.

Run locally#

git clone https://github.com/nirholas/papertrade-yield
cd papertrade-yield
npm install
npm run dev:site

dev:site builds the site and starts wrangler pages dev on port 8795 from the site/ directory.

Build#

npm run build:site

This runs three steps: esbuild bundles site/app.ts to site/public/app.js, scripts/build-docs.mjs renders docs/*.md to site/public/docs/, and the same script writes the discovery files (server card, agent card, API catalog, llms.txt, llms-full.txt, sitemap.xml).

Deploy#

cd site
npx wrangler pages deploy --project-name <your-project> --branch main

Create the project once with npx wrangler pages project create <your-project> --production-branch main. Authenticate with wrangler login or a CLOUDFLARE_API_TOKEN that has Pages edit permission.

Configuration#

Item	Where	Default
`PAPERTRADE_API_URL`	`site/wrangler.toml` `[vars]`	`https://exchange.papertrade.xyz`
Public origin	`SITE_URL` in `src/mcp-tools.ts` and the scripts	`https://papertrade-yield.pages.dev`

If you host under another domain, change the origin where it appears (the build script reads it from package.json homepage) and rebuild so the cards, sitemap and canonical URLs match.

Embedding#

The app route allows framing by the Papertrade OS host and other *.pages.dev pages. ?embed=1 hides the marketing chrome and shows only the product. If you embed it elsewhere, add your origin to frame-ancestors in site/public/_headers.

Checks#

npm run typecheck
npm test
npm run build:site

View this page as markdown