Cons Web

Frontend for Cons, a Solana native routing layer for cross chain tokens and messages. It is a static Vite site (vanilla JS, no framework) and deploys to Vercel as is.

Page	Source	What it is
/	index.html, src/landing/	Landing page
/app.html	app.html, src/app/	Token routing, message routing, activity, receipts, providers
/docs/	content/docs/ → scripts/build-docs.mjs	Docs, generated at build time

Configuration

Every deployment value lives in src/config/cons.js, fed by PUBLIC_* env vars (see .env.example). Components never hardcode an address or endpoint.

Variable	Effect when set	When empty
PUBLIC_SOLANA_NETWORK	mainnet-beta, devnet or testnet	mainnet-beta
PUBLIC_CONS_PROGRAM_ID	Program shown as configured in the app	"Program not deployed", submit disabled
PUBLIC_CONS_TOKEN_MINT	Landing Token CA shows the mint and copy works	"Coming Soon", copy inert
PUBLIC_CONS_API_URL	App reads the Cons API (/v1/quote, /v1/providers, ...)	Labeled preview data from src/data/preview.js
PUBLIC_SOLANA_RPC_URL	Custom RPC	Public cluster RPC
PUBLIC_CONS_DOCS_URL	Docs links point there	/docs/
PUBLIC_CONS_GITHUB_URL	GitHub link appears	GitHub link hidden
PUBLIC_SOLANA_EXPLORER_URL	Explorer base	https://explorer.solana.com

Invalid base58 addresses are ignored, so a typo falls back to the unconfigured state. All values are public. Never put a private key or signing secret in the env.

Integration boundaries

• src/services/routing.js: chains, tokens, providers, quotes, request lookup. API when configured, preview otherwise.
• src/services/program.js: where a route becomes a Solana transaction. Not implemented until the program ships; steps are in the file header.
• src/services/wallet.js: injected Solana wallet connect, public key only. No signing.
• src/data/preview.js: illustrative data (Provider A to E, sample requests with no real signatures).

Commands

npm install
npm run dev      # docs + Vite dev server
npm run build    # docs + static build into dist/
npm test         # config, validation and ranking tests
npm run audit    # copy rules and leftover check

Design

Ported from a reference frontend: its neutral grey scale, warm champagne accent (#e8c289 / #ab8f64), Basier Circle and Geist Mono type, framed page rails, bordered two column panels, two tone headlines and fade up blur reveals on its light surfaces, with the announcement bar, Solana band and footer kept dark as in the reference. All motion pauses offscreen and respects prefers-reduced-motion.