Decentralized crowdfunding on the Stellar network — fast, trustless, and transparent.
Creditedapp is a Web3 crowdfunding platform where anyone can launch a campaign, accept contributions in XLM or any Stellar token, and automatically release or refund funds based on whether the goal is met — all powered by Soroban smart contracts.
Creditedapp lets creators launch on-chain crowdfunding campaigns in minutes. Contributors pledge tokens before a deadline. If the goal is met, the creator withdraws the funds. If not, every contributor gets a full refund — automatically, with no middleman.
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Language | TypeScript 5.9 (strict) |
| Styling | Tailwind CSS 4 |
| Blockchain | Stellar / Soroban |
| Wallet | Freighter, WalletConnect |
| Data Fetching | TanStack React Query |
| Animations | Framer Motion |
| i18n | next-intl (EN, ES, FR, AR, HE) |
| Testing | Jest, Vitest, Playwright |
creditedapp-frontend/
├── src/
│ ├── app/ # Next.js App Router pages
│ ├── components/ # UI components
│ ├── context/ # Wallet, theme, notifications
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Contract client, utilities
│ ├── services/ # Business logic
│ ├── types/ # TypeScript definitions
│ └── i18n/ # Locale config & routing
├── components-lib/ # Shared component library
├── e2e/ # Playwright end-to-end tests
├── messages/ # Translation files
├── public/ # Static assets
├── Dockerfile # Production image
└── next.config.ts # Next.js config + CSP headers
- Node.js 18+
- npm 9+
- Freighter Wallet browser extension
git clone https://github.com/smiletech092-code/creditedapp-frontend.git
cd creditedapp-frontendnpm installcp .env.example .env.localFill in .env.local:
NEXT_PUBLIC_CONTRACT_ID=your_soroban_contract_id
NEXT_PUBLIC_RPC_URL=https://soroban-testnet.stellar.org
NEXT_PUBLIC_NETWORK_PASSPHRASE=Test SDF Network ; September 2015
NEXT_PUBLIC_HORIZON_URL=https://horizon-testnet.stellar.orgnpm run devVisit http://localhost:3000
npm run dev # Development server
npm run build # Production build
npm start # Production server
npm run lint # ESLint
npm run format # Prettier
npm test # Unit tests (Jest)
npm run test:coverage # Coverage report
npm run test:e2e # Playwright E2E tests# Build
docker build -t creditedapp-frontend .
# Run
docker run -p 3000:3000 --env-file .env.local creditedapp-frontend| Variable | Required | Description |
|---|---|---|
NEXT_PUBLIC_CONTRACT_ID |
✅ | Crowdfund contract address |
NEXT_PUBLIC_RPC_URL |
✅ | Soroban RPC endpoint |
NEXT_PUBLIC_NETWORK_PASSPHRASE |
✅ | Stellar network passphrase |
NEXT_PUBLIC_HORIZON_URL |
✅ | Horizon REST API |
NEXT_PUBLIC_PINATA_API_KEY |
❌ | IPFS image uploads (optional) |
- 🚀 Launch campaigns — deploy on-chain in minutes
- 💰 Multi-token support — XLM or any Stellar token
- 🔒 Trustless refunds — pull-based, no single point of failure
- 🌍 5 languages — EN, ES, FR, AR, HE
- 📱 Embeddable widget — embed any campaign on any website
- 🔖 Bookmarks & comparison — save and compare campaigns
- 📊 Live dashboard — real-time campaign stats
- 🌙 Dark / light mode
- creditedapp-contracts — Soroban smart contracts
MIT © smiletech092-code