|
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.
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 with three main repositories:
| Repository | GitHub | Deployment | Description |
|---|---|---|---|
| 📱 Frontend (This Repository) | simutrade-app/simutrade-fe | simutrade.faizath.com | Modern React-based user interface with TypeScript, featuring interactive dashboards, real-time maps, and AI-powered analytics. |
| 🔧 API Backend | simutrade-app/simutrade-api | simutrade-api.faizath.com | RESTful API server handling business logic, data processing, user authentication, and real-time WebSocket communications. |
| 🧠 AI & RAG Backend | simutrade-app/simutrade-ai | Integrated with platform | Specialized AI service providing machine learning models, natural language processing, trade pattern recognition, and intelligent recommendations using Retrieval-Augmented Generation (RAG) techniques. |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
| Technology | Purpose | Description |
|---|---|---|
| Node.js | Runtime | JavaScript runtime for server-side development |
| Express.js | Web Framework | Fast, unopinionated web framework for Node.js |
| CommonJS | Module System | Standard module system for Node.js applications |
| Technology | Purpose | Description |
|---|---|---|
| JWT (jsonwebtoken) | Authentication | JSON Web Token implementation for secure authentication |
| Passport.js | Authentication Strategy | Authentication middleware for Node.js |
| Passport Google OAuth2 | OAuth Integration | Google OAuth2 strategy for Passport.js |
| bcrypt | Password Hashing | Secure password hashing and verification |
| Express Session | Session Management | Session middleware for Express applications |
| Technology | Purpose | Description |
|---|---|---|
| MongoDB | Database | NoSQL document database for flexible data storage |
| Mongoose | ODM | Elegant MongoDB object modeling for Node.js |
| Technology | Purpose | Description |
|---|---|---|
| Body Parser | Request Parsing | Parse incoming request bodies in middleware |
| CORS | Cross-Origin | Enable Cross-Origin Resource Sharing |
| Express | Web Server | Web application framework for Node.js |
| Technology | Purpose | Description |
|---|---|---|
| Cloudflare R2 | Object Storage | S3-compatible object storage service |
| node-cloudflare-r2 | R2 Client | Node.js client for Cloudflare R2 storage |
| Technology | Purpose | Description |
|---|---|---|
| Nodemailer | Email Service | Email sending library for Node.js applications |
| Technology | Purpose | Description |
|---|---|---|
| node-latex | PDF Generation | LaTeX to PDF conversion for document generation |
| Technology | Purpose | Description |
|---|---|---|
| Nodemon | Development | Automatic server restart during development |
| dotenv | Environment | Load environment variables from .env file |
-
Clone the API Repository
git clone https://github.com/simutrade-app/simutrade-api.git cd simutrade-api -
Install Dependencies
npm install
-
Environment Configuration
cp template.env .env # Edit .env with your configuration -
Start Development Server
npm run dev
-
Start Production Server
npm start
| Command | Description |
|---|---|
npm start |
Start production server |
npm run dev |
Start development server with auto-restart |
npm install |
Install all dependencies |
- Node.js: Version 18 or higher
- npm: Version 8 or higher
- MongoDB: Database server for data storage
- Environment Variables: Configure
.envfile with required settings
The API is automatically deployed to api.simutrade.app using modern CI/CD pipelines with:
- API Backend: api.simutrade.app
- Frontend: simutrade.app
- AI Services: Integrated with the main platform
Monitor the real-time status of all SimuTrade services:
- Status Page: status.simutrade.app
- Services Monitored:
- 🌐 SimuTrade Web (simutrade.app)
- 🔗 SimuTrade API (api.simutrade.app)
- 🤖 SimuTrade AI
- 🗄️ SimuTrade MongoDB
- 📡 SimuTrade CDN (cdn.simutrade.app)
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 Node.js and Express.js best practices
- Use proper error handling and logging
- Write comprehensive tests for new features
- Update API documentation as needed
- Node.js Team for the amazing runtime
- Express.js Team for the robust web framework
- MongoDB Team for the flexible database solution
- All Contributors who help make SimuTrade better
- Website: simutrade.app
- API Documentation: api.simutrade.app
- 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