Imported from zonelessdev/zoneless (
AGENTS.md). Install upstream withnpx skills add zonelessdev/zoneless. Copyright stays with the author.
AGENTS.md
Zoneless is an open-source, Stripe-compatible payments platform that uses USDC on Solana. Platforms like marketplaces can self-host their own instance.
This is an Nx monorepo with an Angular frontend (dashboard, checkout, and connected-account onboarding) and an Express API.
Design
The API, object shapes, webhook events, and dashboard flows should match Stripe. If you are unsure how something should look, check the Stripe docs and follow that structure. Zoneless uses USDC, Solana wallets, and crypto instead of cards and bank accounts.
Prefer existing patterns in this repo over new ones. Do not add a dependency unless the work cannot be done with what is already here.
Code
- Write DRY TypeScript that matches the existing formatting, folder structure, and code structure
- PascalCase for function names, camelCase for variables
- Prefer
constoverlet; useasync/await - Standalone Angular components with signals for state
- Zod for API request validation
- Reuse styles from the styles folder
- Remove unused code
- Comments only where the code cannot say it clearly
Changes
Keep diffs small and focused. Add tests for behaviour you change. Do not produce one large untested patch.
Human process, PR size, and how to pick work are in CONTRIBUTING.md.