Freelance with Confidence. Get Paid Securely.
TaskChain is a Web3-powered freelancing platform built on the Stellar blockchain. It is designed to protect both freelancers and clients using blockchain-based escrow payments, milestone tracking, and transparent dispute resolution.
By leveraging Stellar's fast and low-cost network, TaskChain ensures that payments are secure, transparent, and instant, removing the need for traditional intermediaries and high platform fees.
TaskChain reimagines the freelancing experience by solving the core issue of trust.
- Trustless Escrow: Payments are held in smart contracts and only released when milestones are met.
- Instant Payouts: Once approved, funds are transferred instantly via the Stellar network.
- Zero Platform Fees: We believe freelancers should keep what they earn.
- Transparent Track Record: All reviews and project histories are stored on the blockchain, ensuring a verified reputation system.
- Framework: Next.js 15 (App Router)
- Styling: Tailwind CSS
- UI Components: Radix UI & Shadcn UI
- Icons: Lucide React
- State Management/Forms: React Hook Form & Zod
- Database: Neon Postgres (Serverless)
- ORM/Query Builder:
@neondatabase/serverless - Deployment: Vercel
- Network: Stellar (Testnet/Mainnet)
- Contracts: Soroban Smart Contracts (Planned)
- Integration:
stellar-sdk(Planned)
task_chain/
├── app/ # Next.js App Router pages and global styles
├── components/ # Reusable UI components
│ └── ui/ # shadcn/ui primitive components
├── lib/ # Shared utilities and database configuration
├── public/ # Static assets (images, icons, etc.)
├── scripts/ # Database migrations and helper scripts
├── styles/ # Global CSS and theme configurations
├── .env.example # Template for environment variables
├── package.json # Project dependencies and scripts
└── tsconfig.json # TypeScript configuration
app/: Contains the main application routes. Currently features a high-conversion landing page.components/: Houses all React components. Components are organized by feature (e.g.,hero.tsx,features.tsx).lib/: Includesdb.tsfor Neon database connection andutils.tsfor Tailwind merging.scripts/: Contains SQL migration files like001-create-tables.sqlfor setting up the database schema.
- Node.js: v18 or later
- npm / pnpm / yarn
- Neon Database Account: For Postgres storage.
-
Clone the repository:
git clone https://github.com/your-username/task_chain.git cd task_chain -
Install dependencies:
pnpm install # or npm install -
Set up environment variables: Copy
.env.exampleto.envand fill in your database credentials.cp env.example .env
Update
.env:DATABASE_URL=postgres://user:password@hostname/dbname
-
Initialize the database: Run the migration script located in
scripts/001-create-tables.sqlagainst your Neon database instance. -
Run the development server:
pnpm dev # or npm run dev -
Open the browser: Navigate to http://localhost:3000 to see the application.
- Phase 1: Wallet authentication (Stellar/Freighter integration)
- Phase 2: Smart contract escrow integration (Soroban)
- Phase 3: Milestone-based contracts & dashboard
- Phase 4: Dispute resolution logic & DAO governance
- Phase 5: Freelancer profiles & verification system
We welcome contributions from the community!
- Fork the repository.
- Create a branch:
git checkout -b feature/your-feature-name. - Commit changes:
git commit -m 'Add some feature'. - Push to branch:
git push origin feature/your-feature-name. - Open a Pull Request.
Please ensure your code follows the existing style and includes proper documentation.
This project is licensed under the MIT License. See the LICENSE file for details.
If you like the vision of TaskChain, star the repo ⭐ and join us in building the future of secure freelancing.
TaskChain — Where Freelancing Meets Trust.