|
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.
- 🤖 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 was selected as a Top 10 Finalist in the prestigious Google APAC Solutions Challenge 2025 hackathon! 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 Solutions Challenge 2025
- Archived Competition Page: Archive Version
Our team at Google Philippines Office and the awarding ceremony at Asian Development Bank
This achievement demonstrates SimuTrade's potential to revolutionize global trade simulation and its recognition by leading technology and development organizations.
SimuTrade is built as a modular, microservices-based architecture with three main repositories:
Repository: simutrade-app/simutrade-fe
Live URL: simutrade.app
Description: Modern React-based user interface with TypeScript, featuring interactive dashboards, real-time maps, and AI-powered analytics.
Repository: simutrade-app/simutrade-api
Live URL: api.simutrade.app
Description: RESTful API server handling business logic, data processing, user authentication, and real-time WebSocket communications.
Repository: simutrade-app/simutrade-ai
Description: 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 |
|---|---|---|
| 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 |
-
Clone the Frontend Repository
git clone https://github.com/simutrade-app/simutrade-fe.git cd simutrade-fe -
Install Dependencies
npm install
-
Start Development Server
npm run dev
-
Open in Browser Navigate to
http://localhost:5173to view the application.
| Command | Description |
|---|---|
npm run dev |
Start development server with hot reload |
npm run build |
Build production-ready application |
npm run preview |
Preview production build locally |
npm run lint |
Run ESLint for code quality checks |
npm run lint:fix |
Auto-fix ESLint issues |
npm run format |
Format code with Prettier |
npm run test |
Run Jest test suite |
npm run test:watch |
Run tests in watch mode |
npm run test:coverage |
Generate test coverage report |
- Node.js: Version 18 or higher
- npm: Version 8 or higher
- Modern Browser: Chrome, Firefox, Safari, or Edge with ES6+ support
The application is automatically deployed to simutrade.app using modern CI/CD pipelines with:
- Frontend: Cloudflare Pages deployment
- API Backend: api.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 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.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