From May 6th, 2026, Simutrade will transition to new domains as 🌐 Website:simutrade.faizath.com (formerly simutrade.app) |
Simutrade is a cutting-edge AI-powered platform that revolutionizes trade supply chain simulation and analysis. Built with modern web technologies, it provides businesses, traders, and analysts with powerful tools to simulate, analyze, and optimize global trade scenarios in real-time.
The Google APAC Solution Challenge 2025 is Google's annual region-wide hackathon for students across the Asia-Pacific. Teams are challenged to build real-world solutions to problems aligned with the United Nations Sustainable Development Goals (SDGs) using Google technologies — and compete for a place among the region's top teams.
Simutrade was built specifically for this hackathon, under the Trade challenge topic — addressing how technology can make global trade more accessible, efficient, and data-driven for businesses and emerging economies.
Simutrade was selected as a Top 10 Finalist in the prestigious Google APAC Solution Challenge 2025! Our team ITBebas had the incredible opportunity to travel to the Philippines and present our solution at the Asian Development Bank Headquarters.
Simutrade recognized as Top 10 Finalist in Google APAC Solutions Challenge 2025
- 🏢 Google Philippines Office Visit: Our team had the privilege of visiting Google's Philippines office, experiencing the innovative culture and meeting with Google engineers
- 🏛️ Asian Development Bank Presentation: We presented Simutrade at the Asian Development Bank Headquarters, showcasing our AI-powered trade simulation platform to industry experts
- 🎯 Top 10 Achievement: While we didn't reach the Top 3, being selected as a Top 10 finalist was an incredible honor and validation of our solution's potential
- 🤝 Networking & Learning: The experience provided invaluable networking opportunities and insights into the future of trade technology
- Official Competition: Google APAC Solution Challenge 2025
- Archived Competition Page: Archive Version
 🏢 Our team visiting the Google Philippines Office |  👋 Team introduction at the Google Philippines Office |
 🛰️ The Simutrade booth at the Asian Development Bank HQ |  🏆 The Top 3 awarding ceremony at the Asian Development Bank HQ |
This achievement demonstrates Simutrade's potential to revolutionize global trade simulation and its recognition by leading technology and development organizations.
 Aththariq Lisan Qur'an Daulah Sentono Frontend Dev 
aththariq
aththariqlisan
|  Dama Dhananjaya Daliman ML Dev
RunningPie
damaddaliman
|  Muhammad Faiz Atharrahman Backend Dev
faizath
faizath
|  Muhammad Rafi Dhiyaulhaq Project/Product Manager
rafidhiyaulh
rafidhiyaulh
|
Global trade and supply-chain planning is fragmented, slow, and difficult to model. Before committing real capital, traders and small-to-medium enterprises (SMEs) struggle to answer basic questions: Which route is cheapest? What tariffs and duties apply? How long will it take? What disrupts the journey?
- Scattered information — routes, costs, tariffs, and logistics data live across disconnected systems and spreadsheets.
- High barrier to entry — professional trade-modeling tools are expensive and complex, leaving SMEs, students, and analysts underserved.
- No safe space to experiment — there is no accessible "sandbox" to simulate a trade journey and compare scenarios before real money is on the line.
- Reactive, not predictive — decisions are made without data-driven forecasting of risk, cost, and time.
Simutrade turns trade planning into an interactive, AI-assisted simulation — letting anyone model, compare, and optimize a trade journey in minutes instead of weeks:
- 🤖 AI-Powered Simulation Engine — model trade routes, costs, tariffs, and timelines and get instant, data-driven feedback on each scenario.
- 🌍 Interactive Global Maps — visualize trade flows and supply-chain networks in real time to understand the full journey at a glance.
- 📊 Real-Time Analytics — dashboards surface KPIs, sentiment, and trend forecasting so decisions are predictive rather than reactive.
- 💬 AI Assistant (RAG) — a Retrieval-Augmented Generation assistant answers trade questions and recommends optimal strategies in plain language.
- 🎯 Mission-Based Strategy — guided, goal-oriented workflows help users identify opportunities and de-risk their plans before committing.
Together these make professional-grade trade simulation accessible, fast, and affordable for SMEs, analysts, students, and policy makers alike.
- 🤖 AI-Powered Analysis: Advanced machine learning algorithms for trade pattern recognition and prediction
- 🌍 Interactive Global Maps: Real-time visualization of trade flows and supply chain networks
- 📊 Advanced Analytics: Comprehensive dashboards with KPIs, sentiment analysis, and trend forecasting
- 🔄 Real-time Simulation: Live trade scenario modeling with instant feedback
- 🎯 Strategic Planning: Mission-based trading strategies and opportunity identification
- 💬 AI Assistant: Intelligent chat interface for trade insights and recommendations
- 📈 Data Visualization: Rich charts, graphs, and interactive components for data analysis
- Trade Analysts: Professionals analyzing global trade patterns and market trends
- Supply Chain Managers: Teams optimizing logistics and distribution networks
- Business Strategists: Decision-makers planning international expansion
- Students & Educators: Learning global trade dynamics through interactive simulation
- Policy Makers: Government officials understanding trade impact and regulations
Simutrade is built as a modular, microservices-based architecture spanning the platform, its AI service, and the dataset and model behind it:
| Repository | GitHub | Hugging Face | Deployment | Description |
|---|---|---|---|---|
| 📱 Frontend | simutrade-app/simutrade-fe | — | simutrade.faizath.com | React + TypeScript interface with interactive dashboards, real-time maps, and AI-powered analytics. |
| 🔧 API Backend | simutrade-app/simutrade-api | — | simutrade-api.faizath.com | RESTful API handling business logic, authentication, and real-time WebSocket communications. |
| 🧠 AI & RAG Backend | simutrade-app/simutrade-ai | — | Integrated with platform | RAG retrieval over trade documents using Gemini embeddings and ChromaDB. |
| 📊 Dataset | simutrade-app/simutrade-rag-sft-28k | simutrade/simutrade-rag-sft-28k | Offline / Colab | 27,839 bilingual RAG SFT examples and the 1,385-chunk grounding corpus distilled from the AI service. |
| 🎓 Model | simutrade-app/simutrade-v1-clm-rag-gemma3-4b-it-adapter | simutrade/simutrade-v1-clm-rag-gemma3-4b-it-adapter | Offline / Colab | QLoRA adapter finetuned from gemma-3-4b-it on the dataset above. |
 |  |
 |  |
 |  |
 |  |
 |  |
 |  |
 |  |
 |  |
 |  |
 |  |
 |  |
 |  |
| Technology | Purpose | Description |
|---|---|---|
| React 18 | UI Framework | Modern component-based architecture with hooks and concurrent features |
| TypeScript | Type Safety | Static type checking for enhanced code quality and developer experience |
| Vite | Build Tool | Lightning-fast development server and optimized production builds |
| Technology | Purpose | Description |
|---|---|---|
| Tailwind CSS | Styling | Utility-first CSS framework for rapid custom design development |
| Radix UI | Components | Accessible, unstyled UI primitives for building design systems |
| Ant Design | UI Library | Comprehensive React components with polished design resources |
| Lucide React | Icons | Beautiful, consistent icon library for React applications |
| Font Awesome | Icons | Popular scalable vector icons with React components |
| Technology | Purpose | Description |
|---|---|---|
| Recharts | Charts | Composable charting library built on React and D3 |
| Leaflet + React Leaflet | Maps | Interactive maps with React bindings for geospatial visualization |
| React Resizable Panels | Layout | Flexible draggable and resizable panel layouts |
| Technology | Purpose | Description |
|---|---|---|
| React Query | Server State | Powerful data fetching, caching, and synchronization |
| React Hook Form | Forms | Performant form library with validation and state management |
| Zod | Validation | TypeScript-first schema validation for data parsing |
| Technology | Purpose | Description |
|---|---|---|
| Axios | HTTP Client | Promise-based HTTP client for API requests |
| Socket.IO Client | Real-time | Bidirectional event-based communication for live updates |
| Technology | Purpose | Description |
|---|---|---|
| GSAP | Animation | High-performance animation library for complex interactions |
| Embla Carousel | Carousel | Lightweight, touch-friendly carousel component |
| React Day Picker | Date Picker | Accessible date selection component |
| Technology | Purpose | Description |
|---|---|---|
| ESLint | Code Quality | Static analysis tool for finding and fixing code issues |
| Prettier | Code Formatting | Opinionated code formatter for consistent style |
| PostCSS | CSS Processing | CSS transformation with JavaScript plugins |
| Jest | Testing | JavaScript testing framework with React Testing Library |
| Technology | Purpose | Description |
|---|---|---|
| date-fns | Date Manipulation | Lightweight library for modern date operations |
| React Markdown | Content | Markdown rendering component for rich text content |
| Sonner | Notifications | Minimal toast notification library with animations |
| Vaul | Modals | Accessible modal component with better ergonomics |
| clsx | Styling | Utility for conditionally joining classNames |
| React Router DOM | Routing | Standard routing library for React navigation |
We welcome contributions from the community! Here's how you can help:
- Use GitHub Issues to report bugs
- Include steps to reproduce the issue
- Provide system information and error logs
- Submit feature requests via GitHub Issues
- Describe the use case and expected behavior
- Consider the impact on existing functionality
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes and add tests
- Run the test suite:
npm test - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
- Follow TypeScript best practices
- Use ESLint and Prettier for code formatting
- Write comprehensive tests for new features
- Update documentation as needed
- React Team for the amazing framework
- Vite Team for the lightning-fast build tool
- Tailwind CSS for the utility-first CSS framework
- Radix UI for accessible component primitives
- All Contributors who help make Simutrade better
- Website: simutrade.faizath.com
- API Documentation: simutrade-api.faizath.com
- Email: contact@simutrade.faizath.com
- Issues: GitHub Issues
- Discussions: GitHub Discussions
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by the Simutrade Team