NexusPool is a community-first savings circle platform built on Stacks. It modernizes rotating savings groups with transparent rules, trusted payouts, and member reputation at the nexus of financial collaboration.
- Circle management for creating, joining, and running shared savings pools
- Automated payouts with predictable schedules and transparent records
- Trust signals via reputation, participation history, and badges
- Wallet-ready flows for Stacks-native deposits and withdrawals
- Node.js v18+
- npm v9+
git clone https://github.com/doej/nexus-pool.git
cd nexus-pool
npm installcd frontend
npm install
npm run devclarinet checknexus-pool/
├── contracts/ # Clarity smart contracts
│ ├── stacksusu-core-v7.clar
│ ├── stacksusu-escrow-v7.clar
│ ├── stacksusu-governance-v7.clar
│ └── stacksusu-reputation-v7.clar
├── frontend/ # React + Vite web app
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── hooks/ # Custom React hooks
│ │ ├── lib/ # Contract integration layer
│ │ ├── utils/ # Helper utilities
│ │ └── pages/ # Page components
│ └── package.json
├── docs/ # Architecture and guides
│ ├── FRONTEND_ARCHITECTURE.md
│ ├── CONTRACTS.md
│ └── API.md
└── README.md # Project documentation
- Contract Layer: Centralized integration with Clarity contracts
- Custom Hooks: React hooks for blockchain interactions
- Transaction Monitoring: Real-time transaction status tracking
- Post Conditions: Safe STX transfers with verification
- React 19: Modern React with hooks and concurrent features
- TypeScript: Full type safety across the application
- Stacks.js: Seamless blockchain integration
- Responsive Design: Mobile-first, accessible UI
- Audit Logging for transparency
- Circle Discovery for finding savings groups
- Improved Error Messages for better UX
- API Documentation for developers
- Integration Tests for reliability
- Recurring Contributions for automated savings
- Notifications System for staying informed
See CONTRIBUTING.md for local setup, testing, and contribution guidelines.
MIT