Conceal Bridge UX

Angular 21 SPA for bridging native ₡CCX and wrapped $wCCX on EVM networks.

Use the Bridge | GitHub Pages Mirror | Backend API

What It Does

Seamless 1:1 conversions between privacy-focused ₡CCX and DeFi-compatible $wCCX tokens.

Network	Max Supply	Contract
Ethereum	500k wCCX	View on Etherscan
BSC	350k wCCX	View on BscScan
Polygon	500k wCCX	View on PolygonScan

Supported Wallets: MetaMask, Trust Wallet, Binance Wallet

Quick Start

npm install
npm start         # Dev server at http://localhost:4200

Prerequisites: Node.js v22+

Commands

Command	Purpose
npm start	Dev server with hot reload
npm test	Unit tests (Vitest)
npm run e2e	E2E tests (Playwright)
npm run build	Production build
npm run lint	ESLint check
npm run format	Prettier format

Tech Stack

• Framework: Angular 21 (Standalone Components, Signals, OnPush)
• UI Library: ZardUI (Shadcn-like components for Angular)
• Styling: Tailwind CSS v4
• Web3: Viem
• Testing: Vitest + Playwright
• Quality: ESLint + Prettier + Husky (Pre-commit hooks)

Project Structure

src/app/
├── core/       # Services: BridgeApiService, EvmWalletService
├── pages/      # Routes: home, swap, not-found
└── shared/     # Components: wallet, qr-code, transaction-history

See docs/build_guide.md for detailed architecture.

Configuration

Environment	Backend URL	File
Development	bridge.conceal.network/testing/backend	src/environments/environment.development.ts
Production	bridge.conceal.network/backend	src/environments/environment.ts

Deployment

Deployment is automatic via GitHub Actions when changes reach master:

• Code changes: Merge PR to master
• Docs/releases: Push directly to master

See docs/deployment.md for manual deployment and rollback procedures.

Documentation

Topic	Link
Architecture	docs/bridge_architecture.md
Backend API	docs/backend_api.md
Web3 Integration	docs/web3_integrations.md
Testing	docs/testing.md
Security	docs/security.md

Contributing

• Workflow: Feature branches → PR → merge to master
• Commits: Conventional Commits (feat:, fix:, docs:, chore:)
• Issues: GitHub Issues - gh issue list to see open work

For AI agents and developers: See AGENTS.md for critical rules and workflows.

Related

• conceal-wswap - Backend API
• ConcealNetwork - Conceal ecosystem

License

This project is licensed under the MIT License.