Learn Blockchain Development with Open Source

An open-source platform powered by PHP, Symfony, React, and Soroban smart contracts. Learn blockchain development with ready-to-run local code, or use it as a technical foundation for your organization to build upon.

Equillar is a complete, open-source blockchain application that serves dual purposes:

1. Educational Resource: Learn how to build real-world blockchain applications by exploring, running, and modifying working code
2. Technical Foundation: Use it as a starting point for prototyping and experimenting with blockchain-based solutions in a local/test environment

Built as an investment platform on the Stellar blockchain using Soroban smart contracts, Equillar demonstrates how to integrate distributed ledger technology with modern web applications. All contracts are deployed on the Soroban testnet, making it perfect for learning and experimentation.

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See the LICENSE file for details.

• Complete, working codebase: Explore a full-stack application integrating blockchain technology from end to end
• Smart contract integration: Learn how to interact with Soroban contracts from a web application
• Modern tech stack: Experience real-world development with PHP/Symfony, React/TypeScript, and blockchain technology
• Hands-on experimentation: Run locally with Docker, modify code, and see results immediately
• Well-documented: Clear folder structures and comprehensive documentation to guide your learning journey

• Ready-to-fork: Clone and customize for your organization's specific prototyping needs
• End-to-end architecture: Backend (Symfony + PHP) and frontend (React + TypeScript) fully integrated
• Extensible design: Modular architecture makes it easy to add features or modify existing ones
• Test environment: Safe testnet deployment for experimenting with blockchain features
• Real implementation patterns: Learn from production-quality code organization and best practices

• Blockchain wallet integration: See how Freighter wallet connects to Soroban contracts
• Transaction handling: Learn how to simulate, sign, and submit blockchain transactions
• Smart contract interaction: Understand contract deployment, invocation, and error handling
• Modern UI/UX: Material UI components and React patterns for blockchain applications
• Database integration: See how blockchain data syncs with traditional databases (PostgreSQL)
• User flows: Complete investor and company dashboards demonstrating real-world scenarios

Through Equillar's investment platform example, you'll discover:

• How to integrate smart contracts with web applications
• Blockchain transaction lifecycle management
• Wallet connectivity and user authentication
• Handling contract errors and edge cases
• State management between blockchain and traditional databases
• Building user interfaces for blockchain interactions
• Testing blockchain applications locally

• Backend: PHP 8.3+, Symfony 7.x
• Frontend: React 18+, TypeScript, Material UI
• Blockchain: Stellar, Soroban smart contracts (Rust)
• Database: PostgreSQL
• Build Tools: Webpack Encore, Symfony UX
• Deployment: Docker Compose

See the full Tech Stack documentation for details.

Visit the Equillar docs site to start and learn

• Learn blockchain development with a complete, working example
• Understand smart contract integration patterns
• Experiment with blockchain features in a safe environment
• Build your portfolio with blockchain projects

• Prototype blockchain solutions quickly
• Evaluate Stellar/Soroban technology for your use case
• Use as a foundation for hackathons or internal projects
• Train your team on blockchain development

• Teaching material for blockchain courses
• Real-world example for technical workshops
• Reference implementation for blockchain concepts

We welcome contributions from the community! Whether you're:

• Fixing bugs or improving documentation
• Adding new features or examples
• Suggesting improvements to the learning materials
• Sharing how you've used Equillar in your projects

Please read our CONTRIBUTING guidelines before submitting issues or pull requests.

For questions, ideas, or support:

• Issues: Report bugs or request features via GitHub Issues
• Discussions: Ask questions or share ideas in GitHub Discussions
• Learning: Check our documentation and explore the code

See our ROADMAP for planned features and improvements.

Start your blockchain development journey today! Clone Equillar, explore the code, and learn by doing.