faizath commited on
Commit
6f344c4
·
verified ·
0 Parent(s):

chore(hf): mirror profile content with LFS-tracked assets

Browse files

Hugging Face rejects plain binary blobs at pre-receive; track images
via Git LFS so the org card repo accepts the push.

Files changed (38) hide show
  1. .gitattributes +6 -0
  2. LICENSE +21 -0
  3. README.md +425 -0
  4. profile/README.md +425 -0
  5. profile/assets/Demo_Video_Placeholder.png +3 -0
  6. profile/assets/Google_Philippines_Office_Visit.jpg +3 -0
  7. profile/assets/Simutrade_Booth_at_Asian_Development_Bank_HQ.jpg +3 -0
  8. profile/assets/Team_Introduction_at_Google_Philippines_Office.jpg +3 -0
  9. profile/assets/Top_10_Google_APAC_Solutions_Challenge.webp +3 -0
  10. profile/assets/Top_3_Awarding_at_Asian_Development_Bank_HQ.jpg +3 -0
  11. profile/assets/demo.gif +3 -0
  12. profile/assets/github.svg +1 -0
  13. profile/assets/linkedin.svg +1 -0
  14. profile/assets/logo.png +3 -0
  15. profile/assets/screenshots/1.png +3 -0
  16. profile/assets/screenshots/10.png +3 -0
  17. profile/assets/screenshots/11.png +3 -0
  18. profile/assets/screenshots/12.png +3 -0
  19. profile/assets/screenshots/13.png +3 -0
  20. profile/assets/screenshots/14.png +3 -0
  21. profile/assets/screenshots/15.png +3 -0
  22. profile/assets/screenshots/16.png +3 -0
  23. profile/assets/screenshots/17.png +3 -0
  24. profile/assets/screenshots/18.png +3 -0
  25. profile/assets/screenshots/19.png +3 -0
  26. profile/assets/screenshots/2.png +3 -0
  27. profile/assets/screenshots/20.png +3 -0
  28. profile/assets/screenshots/21.png +3 -0
  29. profile/assets/screenshots/22.png +3 -0
  30. profile/assets/screenshots/23.png +3 -0
  31. profile/assets/screenshots/24.png +3 -0
  32. profile/assets/screenshots/3.png +3 -0
  33. profile/assets/screenshots/4.png +3 -0
  34. profile/assets/screenshots/5.png +3 -0
  35. profile/assets/screenshots/6.png +3 -0
  36. profile/assets/screenshots/7.png +3 -0
  37. profile/assets/screenshots/8.png +3 -0
  38. profile/assets/screenshots/9.png +3 -0
.gitattributes ADDED
@@ -0,0 +1,6 @@
 
 
 
 
 
 
 
1
+ *.png filter=lfs diff=lfs merge=lfs -text
2
+ *.jpg filter=lfs diff=lfs merge=lfs -text
3
+ *.jpeg filter=lfs diff=lfs merge=lfs -text
4
+ *.webp filter=lfs diff=lfs merge=lfs -text
5
+ *.gif filter=lfs diff=lfs merge=lfs -text
6
+ *.mp4 filter=lfs diff=lfs merge=lfs -text
LICENSE ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ MIT License
2
+
3
+ Copyright (c) 2025 SimuTrade Developers <dev@simutrade.faizath.com>
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
README.md ADDED
@@ -0,0 +1,425 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <div align="center">
2
+ <table border="1">
3
+ <tr>
4
+ <td align="center" style="padding: 20px;">
5
+ <h3>📢 Domain & Email Migration Notice</h3>
6
+ <p>From <b>May 6th, 2026</b>, Simutrade will transition to new domains as <code>simutrade.app</code> will not be renewed:</p>
7
+ <p>🌐 <b>Website:</b> <a href="https://simutrade.faizath.com">simutrade.faizath.com</a> (formerly <i>simutrade.app</i>)<br>
8
+ ⚙️ <b>API:</b> <a href="https://simutrade-api.faizath.com">simutrade-api.faizath.com</a> (formerly <i>api.simutrade.app</i>)<br>
9
+ 📧 <b>Email:</b> <a href="mailto:contact@simutrade.faizath.com">contact@simutrade.faizath.com</a> (formerly <i>contact@simutrade.app</i>)<br>
10
+ 🛰️ <b>CDN:</b> <a>simutrade-cdn.faizath.com</a> (formerly <i>cdn.simutrade.app</i>)<br>
11
+ 📈 <b>Status Pages:</b> <a href="https://status.faizath.com/status/simutrade">https://status.faizath.com/status/simutrade</a> (formerly <i>status.simutrade.app</i>)
12
+ </p>
13
+ </td>
14
+ </tr>
15
+ </table>
16
+ </div>
17
+
18
+ <div align="center">
19
+ <img src="profile/assets/logo.png" alt="Simutrade Logo" width="100%"/>
20
+ <h1 align="center">🚀 Simutrade</h1>
21
+ <h3 align="center">AI-Powered Trade Supply Chain Simulation Platform</h3>
22
+
23
+ <p align="center">
24
+ <img src="https://img.shields.io/badge/Google%20APAC%20Solutions%20Challenge-Top%2010%20Finalist-4285F4?style=for-the-badge&logo=google&logoColor=white" alt="Google APAC Solutions Challenge Top 10 Finalist"/>
25
+ </p>
26
+
27
+ <p align="center">
28
+ <a href="https://simutrade.faizath.com">🌐 Live Demo</a> •
29
+ <a href="https://simutrade-api.faizath.com">🔗 API</a> •
30
+ <a href="https://status.faizath.com/status/simutrade">📊 Status</a> •
31
+ <a href="#-competition-achievement">🏆 Achievement</a> •
32
+ <a href="#-repository-architecture">📁 Repositories</a> •
33
+ <a href="#-tech-stacks">🛠️ Tech Stack</a>
34
+ </p>
35
+ </div>
36
+
37
+ ## 🎬 Demo Video
38
+
39
+ <div align="center">
40
+ <a href="https://drive.google.com/file/d/14eXdPWHsSgBYRP-9KojyD9x7LFupAVNk/preview">
41
+ <img src="profile/assets/demo.gif" alt="Simutrade Demo Video" width="100%"/>
42
+ </a>
43
+ <p><em>▶️ Click to watch the Simutrade demo</em></p>
44
+ </div>
45
+
46
+ ## 🌟 What is Simutrade?
47
+
48
+ **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.
49
+
50
+ ## 🏆 Competition Achievement
51
+
52
+ ### 🌏 About the Google APAC Solution Challenge 2025
53
+
54
+ The **[Google APAC Solution Challenge 2025](https://hack2skill.com/event/apacsolutionchallenge)** 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.
55
+
56
+ **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.
57
+
58
+ ### 🥇 Top 10 Finalist
59
+
60
+ **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.
61
+
62
+ <div align="center">
63
+ <img src="profile/assets/Top_10_Google_APAC_Solutions_Challenge.webp" alt="Top 10 Google APAC Solutions Challenge" width="600"/>
64
+ <p><em>Simutrade recognized as Top 10 Finalist in Google APAC Solutions Challenge 2025</em></p>
65
+ </div>
66
+
67
+ ### 🌟 Our Journey
68
+
69
+ - **🏢 Google Philippines Office Visit**: Our team had the privilege of visiting Google's Philippines office, experiencing the innovative culture and meeting with Google engineers
70
+ - **🏛️ Asian Development Bank Presentation**: We presented Simutrade at the Asian Development Bank Headquarters, showcasing our AI-powered trade simulation platform to industry experts
71
+ - **🎯 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
72
+ - **🤝 Networking & Learning**: The experience provided invaluable networking opportunities and insights into the future of trade technology
73
+
74
+ ### 📚 Competition Resources
75
+
76
+ - **Official Competition**: [Google APAC Solution Challenge 2025](https://hack2skill.com/event/apacsolutionchallenge)
77
+ - **Archived Competition Page**: [Archive Version](https://archive.faizath.com/archive/1751469385.462976/index.html)
78
+
79
+ ### 📸 Journey Gallery
80
+
81
+ <div align="center">
82
+ <table>
83
+ <tr>
84
+ <td align="center" width="50%">
85
+ <img src="profile/assets/Google_Philippines_Office_Visit.jpg" alt="Google Philippines Office Visit" width="100%"/>
86
+ <p><em>🏢 Our team visiting the Google Philippines Office</em></p>
87
+ </td>
88
+ <td align="center" width="50%">
89
+ <img src="profile/assets/Team_Introduction_at_Google_Philippines_Office.jpg" alt="Team Introduction at Google Philippines Office" width="100%"/>
90
+ <p><em>👋 Team introduction at the Google Philippines Office</em></p>
91
+ </td>
92
+ </tr>
93
+ <tr>
94
+ <td align="center" width="50%">
95
+ <img src="profile/assets/Simutrade_Booth_at_Asian_Development_Bank_HQ.jpg" alt="Simutrade Booth at Asian Development Bank HQ" width="100%"/>
96
+ <p><em>🛰️ The Simutrade booth at the Asian Development Bank HQ</em></p>
97
+ </td>
98
+ <td align="center" width="50%">
99
+ <img src="profile/assets/Top_3_Awarding_at_Asian_Development_Bank_HQ.jpg" alt="Awarding Ceremony at Asian Development Bank HQ" width="100%"/>
100
+ <p><em>🏆 The Top 3 awarding ceremony at the Asian Development Bank HQ</em></p>
101
+ </td>
102
+ </tr>
103
+ </table>
104
+ </div>
105
+
106
+ This achievement demonstrates Simutrade's potential to revolutionize global trade simulation and its recognition by leading technology and development organizations.
107
+
108
+ ---
109
+
110
+ ## Team
111
+
112
+ <div align="center">
113
+
114
+ <table>
115
+ <tr>
116
+ <td width="220" align="center" valign="top" style="width:220px;text-align:center;vertical-align:top">
117
+ <a href="https://github.com/aththariq" style="display:inline-block">
118
+ <img src="https://github.com/aththariq.png?size=140" width="120" height="120" alt="Aththariq Lisan Qur'an Daulah Sentono" style="border-radius:50%;margin:0" />
119
+ </a>
120
+ <br /><br />
121
+ <b>Aththariq Lisan Qur'an Daulah Sentono</b><br />
122
+ Frontend Dev
123
+ <br /><br />
124
+ <a href="https://github.com/aththariq" style="display:inline-block">
125
+ <img src="profile/assets/github.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
126
+ aththariq
127
+ </a>
128
+ <br />
129
+ <a href="https://www.linkedin.com/in/aththariqlisan/" style="display:inline-block">
130
+ <img src="profile/assets/linkedin.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
131
+ aththariqlisan
132
+ </a>
133
+ </td>
134
+ <td width="220" align="center" valign="top" style="width:220px;text-align:center;vertical-align:top">
135
+ <a href="https://github.com/RunningPie" style="display:inline-block">
136
+ <img src="https://github.com/RunningPie.png?size=140" width="120" height="120" alt="Dama Dhananjaya Daliman" style="border-radius:50%;margin:0" />
137
+ </a>
138
+ <br /><br />
139
+ <b>Dama Dhananjaya Daliman</b><br />
140
+ ML Dev
141
+ <br /><br />
142
+ <a href="https://github.com/RunningPie" style="display:inline-block">
143
+ <img src="profile/assets/github.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
144
+ RunningPie
145
+ </a>
146
+ <br />
147
+ <a href="https://www.linkedin.com/in/damaddaliman/" style="display:inline-block">
148
+ <img src="profile/assets/linkedin.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
149
+ damaddaliman
150
+ </a>
151
+ </td>
152
+ <td width="220" align="center" valign="top" style="width:220px;text-align:center;vertical-align:top">
153
+ <a href="https://github.com/faizath" style="display:inline-block">
154
+ <img src="https://github.com/faizath.png?size=140" width="120" height="120" alt="Muhammad Faiz Atharrahman" style="border-radius:50%;margin:0" />
155
+ </a>
156
+ <br /><br />
157
+ <b>Muhammad Faiz Atharrahman</b><br />
158
+ Backend Dev
159
+ <br /><br />
160
+ <a href="https://github.com/faizath" style="display:inline-block">
161
+ <img src="profile/assets/github.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
162
+ faizath
163
+ </a>
164
+ <br />
165
+ <a href="https://www.linkedin.com/in/faizath/" style="display:inline-block">
166
+ <img src="profile/assets/linkedin.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
167
+ faizath
168
+ </a>
169
+ </td>
170
+ <td width="220" align="center" valign="top" style="width:220px;text-align:center;vertical-align:top">
171
+ <a href="https://github.com/rafidhiyaulh" style="display:inline-block">
172
+ <img src="https://github.com/rafidhiyaulh.png?size=140" width="120" height="120" alt="Muhammad Rafi Dhiyaulhaq" style="border-radius:50%;margin:0" />
173
+ </a>
174
+ <br /><br />
175
+ <b>Muhammad Rafi Dhiyaulhaq</b><br />
176
+ Project/Product Manager
177
+ <br /><br />
178
+ <a href="https://github.com/rafidhiyaulh" style="display:inline-block">
179
+ <img src="profile/assets/github.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
180
+ rafidhiyaulh
181
+ </a>
182
+ <br />
183
+ <a href="https://www.linkedin.com/in/rafidhiyaulh/" style="display:inline-block">
184
+ <img src="profile/assets/linkedin.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
185
+ rafidhiyaulh
186
+ </a>
187
+ </td>
188
+ </tr>
189
+ </table>
190
+
191
+ </div>
192
+
193
+ ---
194
+
195
+ ## 🎯 The Problem It Solves
196
+
197
+ 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?*
198
+
199
+ - **Scattered information** — routes, costs, tariffs, and logistics data live across disconnected systems and spreadsheets.
200
+ - **High barrier to entry** — professional trade-modeling tools are expensive and complex, leaving SMEs, students, and analysts underserved.
201
+ - **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.
202
+ - **Reactive, not predictive** — decisions are made without data-driven forecasting of risk, cost, and time.
203
+
204
+ ## 💡 How Simutrade Solves It
205
+
206
+ Simutrade turns trade planning into an **interactive, AI-assisted simulation** — letting anyone model, compare, and optimize a trade journey in minutes instead of weeks:
207
+
208
+ - **🤖 AI-Powered Simulation Engine** — model trade routes, costs, tariffs, and timelines and get instant, data-driven feedback on each scenario.
209
+ - **🌍 Interactive Global Maps** — visualize trade flows and supply-chain networks in real time to understand the full journey at a glance.
210
+ - **📊 Real-Time Analytics** — dashboards surface KPIs, sentiment, and trend forecasting so decisions are predictive rather than reactive.
211
+ - **💬 AI Assistant (RAG)** — a Retrieval-Augmented Generation assistant answers trade questions and recommends optimal strategies in plain language.
212
+ - **🎯 Mission-Based Strategy** — guided, goal-oriented workflows help users identify opportunities and de-risk their plans before committing.
213
+
214
+ Together these make professional-grade trade simulation **accessible, fast, and affordable** for SMEs, analysts, students, and policy makers alike.
215
+
216
+ ### ✨ Key Features
217
+
218
+ - 🤖 **AI-Powered Analysis**: Advanced machine learning algorithms for trade pattern recognition and prediction
219
+ - 🌍 **Interactive Global Maps**: Real-time visualization of trade flows and supply chain networks
220
+ - 📊 **Advanced Analytics**: Comprehensive dashboards with KPIs, sentiment analysis, and trend forecasting
221
+ - 🔄 **Real-time Simulation**: Live trade scenario modeling with instant feedback
222
+ - 🎯 **Strategic Planning**: Mission-based trading strategies and opportunity identification
223
+ - 💬 **AI Assistant**: Intelligent chat interface for trade insights and recommendations
224
+ - 📈 **Data Visualization**: Rich charts, graphs, and interactive components for data analysis
225
+
226
+ ### 🎯 Target Users
227
+
228
+ - **Trade Analysts**: Professionals analyzing global trade patterns and market trends
229
+ - **Supply Chain Managers**: Teams optimizing logistics and distribution networks
230
+ - **Business Strategists**: Decision-makers planning international expansion
231
+ - **Students & Educators**: Learning global trade dynamics through interactive simulation
232
+ - **Policy Makers**: Government officials understanding trade impact and regulations
233
+
234
+ ## 🏗️ Repository Architecture
235
+
236
+ Simutrade is built as a modular, microservices-based architecture spanning the platform, its AI service, and the dataset and model behind it:
237
+
238
+ | Repository | GitHub | Hugging Face | Deployment | Description |
239
+ |------------|--------|--------------|------------|-------------|
240
+ | 📱 **Frontend** | [simutrade-app/simutrade-fe](https://github.com/simutrade-app/simutrade-fe) | — | [simutrade.faizath.com](https://simutrade.faizath.com) | React + TypeScript interface with interactive dashboards, real-time maps, and AI-powered analytics. |
241
+ | 🔧 **API Backend** | [simutrade-app/simutrade-api](https://github.com/simutrade-app/simutrade-api) | — | [simutrade-api.faizath.com](https://simutrade-api.faizath.com) | RESTful API handling business logic, authentication, and real-time WebSocket communications. |
242
+ | 🧠 **AI & RAG Backend** | [simutrade-app/simutrade-ai](https://github.com/simutrade-app/simutrade-ai) | — | _Integrated with platform_ | RAG retrieval over trade documents using Gemini embeddings and ChromaDB. |
243
+ | 📊 **Dataset** | [simutrade-app/simutrade-rag-sft-28k](https://github.com/simutrade-app/simutrade-rag-sft-28k) | [simutrade/simutrade-rag-sft-28k](https://huggingface.co/datasets/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. |
244
+ | 🎓 **Model** | [simutrade-app/simutrade-v1-clm-rag-gemma3-4b-it-adapter](https://github.com/simutrade-app/simutrade-v1-clm-rag-gemma3-4b-it-adapter) | [simutrade/simutrade-v1-clm-rag-gemma3-4b-it-adapter](https://huggingface.co/simutrade/simutrade-v1-clm-rag-gemma3-4b-it-adapter) | _Offline / Colab_ | QLoRA adapter finetuned from `gemma-3-4b-it` on the dataset above. |
245
+
246
+
247
+ ## 📸 Screenshots
248
+
249
+ <div align="center">
250
+ <table>
251
+ <tr>
252
+ <td width="50%"><img src="profile/assets/screenshots/1.png" width="100%"/></td>
253
+ <td width="50%"><img src="profile/assets/screenshots/2.png" width="100%"/></td>
254
+ </tr>
255
+ <tr>
256
+ <td width="50%"><img src="profile/assets/screenshots/3.png" width="100%"/></td>
257
+ <td width="50%"><img src="profile/assets/screenshots/4.png" width="100%"/></td>
258
+ </tr>
259
+ <tr>
260
+ <td width="50%"><img src="profile/assets/screenshots/5.png" width="100%"/></td>
261
+ <td width="50%"><img src="profile/assets/screenshots/6.png" width="100%"/></td>
262
+ </tr>
263
+ <tr>
264
+ <td width="50%"><img src="profile/assets/screenshots/7.png" width="100%"/></td>
265
+ <td width="50%"><img src="profile/assets/screenshots/8.png" width="100%"/></td>
266
+ </tr>
267
+ <tr>
268
+ <td width="50%"><img src="profile/assets/screenshots/9.png" width="100%"/></td>
269
+ <td width="50%"><img src="profile/assets/screenshots/10.png" width="100%"/></td>
270
+ </tr>
271
+ <tr>
272
+ <td width="50%"><img src="profile/assets/screenshots/11.png" width="100%"/></td>
273
+ <td width="50%"><img src="profile/assets/screenshots/12.png" width="100%"/></td>
274
+ </tr>
275
+ <tr>
276
+ <td width="50%"><img src="profile/assets/screenshots/13.png" width="100%"/></td>
277
+ <td width="50%"><img src="profile/assets/screenshots/14.png" width="100%"/></td>
278
+ </tr>
279
+ <tr>
280
+ <td width="50%"><img src="profile/assets/screenshots/15.png" width="100%"/></td>
281
+ <td width="50%"><img src="profile/assets/screenshots/16.png" width="100%"/></td>
282
+ </tr>
283
+ <tr>
284
+ <td width="50%"><img src="profile/assets/screenshots/17.png" width="100%"/></td>
285
+ <td width="50%"><img src="profile/assets/screenshots/18.png" width="100%"/></td>
286
+ </tr>
287
+ <tr>
288
+ <td width="50%"><img src="profile/assets/screenshots/19.png" width="100%"/></td>
289
+ <td width="50%"><img src="profile/assets/screenshots/20.png" width="100%"/></td>
290
+ </tr>
291
+ <tr>
292
+ <td width="50%"><img src="profile/assets/screenshots/21.png" width="100%"/></td>
293
+ <td width="50%"><img src="profile/assets/screenshots/22.png" width="100%"/></td>
294
+ </tr>
295
+ <tr>
296
+ <td width="50%"><img src="profile/assets/screenshots/23.png" width="100%"/></td>
297
+ <td width="50%"><img src="profile/assets/screenshots/24.png" width="100%"/></td>
298
+ </tr>
299
+ </table>
300
+ </div>
301
+
302
+ ---
303
+
304
+ ## 🛠️ Tech Stacks
305
+
306
+ ### 🎨 Frontend Framework & Core
307
+ | Technology | Purpose | Description |
308
+ |------------|---------|-------------|
309
+ | **React 18** | UI Framework | Modern component-based architecture with hooks and concurrent features |
310
+ | **TypeScript** | Type Safety | Static type checking for enhanced code quality and developer experience |
311
+ | **Vite** | Build Tool | Lightning-fast development server and optimized production builds |
312
+
313
+ ### 🎨 Styling & UI Components
314
+ | Technology | Purpose | Description |
315
+ |------------|---------|-------------|
316
+ | **Tailwind CSS** | Styling | Utility-first CSS framework for rapid custom design development |
317
+ | **Radix UI** | Components | Accessible, unstyled UI primitives for building design systems |
318
+ | **Ant Design** | UI Library | Comprehensive React components with polished design resources |
319
+ | **Lucide React** | Icons | Beautiful, consistent icon library for React applications |
320
+ | **Font Awesome** | Icons | Popular scalable vector icons with React components |
321
+
322
+ ### 📊 Data Visualization & Maps
323
+ | Technology | Purpose | Description |
324
+ |------------|---------|-------------|
325
+ | **Recharts** | Charts | Composable charting library built on React and D3 |
326
+ | **Leaflet + React Leaflet** | Maps | Interactive maps with React bindings for geospatial visualization |
327
+ | **React Resizable Panels** | Layout | Flexible draggable and resizable panel layouts |
328
+
329
+ ### 🔄 State Management & Data Fetching
330
+ | Technology | Purpose | Description |
331
+ |------------|---------|-------------|
332
+ | **React Query** | Server State | Powerful data fetching, caching, and synchronization |
333
+ | **React Hook Form** | Forms | Performant form library with validation and state management |
334
+ | **Zod** | Validation | TypeScript-first schema validation for data parsing |
335
+
336
+ ### 🌐 Networking & Real-time
337
+ | Technology | Purpose | Description |
338
+ |------------|---------|-------------|
339
+ | **Axios** | HTTP Client | Promise-based HTTP client for API requests |
340
+ | **Socket.IO Client** | Real-time | Bidirectional event-based communication for live updates |
341
+
342
+ ### 🎭 Animation & Interactions
343
+ | Technology | Purpose | Description |
344
+ |------------|---------|-------------|
345
+ | **GSAP** | Animation | High-performance animation library for complex interactions |
346
+ | **Embla Carousel** | Carousel | Lightweight, touch-friendly carousel component |
347
+ | **React Day Picker** | Date Picker | Accessible date selection component |
348
+
349
+ ### 🛠️ Development Tools
350
+ | Technology | Purpose | Description |
351
+ |------------|---------|-------------|
352
+ | **ESLint** | Code Quality | Static analysis tool for finding and fixing code issues |
353
+ | **Prettier** | Code Formatting | Opinionated code formatter for consistent style |
354
+ | **PostCSS** | CSS Processing | CSS transformation with JavaScript plugins |
355
+ | **Jest** | Testing | JavaScript testing framework with React Testing Library |
356
+
357
+ ### 📦 Utility Libraries
358
+ | Technology | Purpose | Description |
359
+ |------------|---------|-------------|
360
+ | **date-fns** | Date Manipulation | Lightweight library for modern date operations |
361
+ | **React Markdown** | Content | Markdown rendering component for rich text content |
362
+ | **Sonner** | Notifications | Minimal toast notification library with animations |
363
+ | **Vaul** | Modals | Accessible modal component with better ergonomics |
364
+ | **clsx** | Styling | Utility for conditionally joining classNames |
365
+ | **React Router DOM** | Routing | Standard routing library for React navigation |
366
+
367
+ ## 🤝 Contributing
368
+
369
+ We welcome contributions from the community! Here's how you can help:
370
+
371
+ ### 🐛 Bug Reports
372
+ - Use GitHub Issues to report bugs
373
+ - Include steps to reproduce the issue
374
+ - Provide system information and error logs
375
+
376
+ ### 💡 Feature Requests
377
+ - Submit feature requests via GitHub Issues
378
+ - Describe the use case and expected behavior
379
+ - Consider the impact on existing functionality
380
+
381
+ ### 🔧 Development Setup
382
+ 1. Fork the repository
383
+ 2. Create a feature branch: `git checkout -b feature/amazing-feature`
384
+ 3. Make your changes and add tests
385
+ 4. Run the test suite: `npm test`
386
+ 5. Commit your changes: `git commit -m 'Add amazing feature'`
387
+ 6. Push to the branch: `git push origin feature/amazing-feature`
388
+ 7. Open a Pull Request
389
+
390
+ ### 📋 Code Standards
391
+ - Follow TypeScript best practices
392
+ - Use ESLint and Prettier for code formatting
393
+ - Write comprehensive tests for new features
394
+ - Update documentation as needed
395
+
396
+ ## 🏆 Acknowledgments
397
+
398
+ - **React Team** for the amazing framework
399
+ - **Vite Team** for the lightning-fast build tool
400
+ - **Tailwind CSS** for the utility-first CSS framework
401
+ - **Radix UI** for accessible component primitives
402
+ - **All Contributors** who help make Simutrade better
403
+
404
+ ## 📞 Support & Contact
405
+
406
+ - **Website**: [simutrade.faizath.com](https://simutrade.faizath.com)
407
+ - **API Documentation**: [simutrade-api.faizath.com](https://simutrade-api.faizath.com)
408
+ - **Email**: [contact@simutrade.faizath.com](mailto:contact@simutrade.faizath.com)
409
+ - **Issues**: [GitHub Issues](https://github.com/simutrade-app/simutrade-fe/issues)
410
+ - **Discussions**: [GitHub Discussions](https://github.com/simutrade-app/simutrade-fe/discussions)
411
+
412
+ ## 📝 License
413
+
414
+ This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
415
+
416
+ ---
417
+
418
+ <div align="center">
419
+ <p>Made with ❤️ by the Simutrade Team</p>
420
+ <p>
421
+ <a href="https://simutrade.faizath.com">🌐 Visit Simutrade</a> •
422
+ <a href="https://github.com/simutrade-app">👥 Our Organization</a> •
423
+ <a href="https://github.com/simutrade-app/simutrade-fe/stargazers">⭐ Star this repo</a>
424
+ </p>
425
+ </div>
profile/README.md ADDED
@@ -0,0 +1,425 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <div align="center">
2
+ <table border="1">
3
+ <tr>
4
+ <td align="center" style="padding: 20px;">
5
+ <h3>📢 Domain & Email Migration Notice</h3>
6
+ <p>From <b>May 6th, 2026</b>, Simutrade will transition to new domains as <code>simutrade.app</code> will not be renewed:</p>
7
+ <p>🌐 <b>Website:</b> <a href="https://simutrade.faizath.com">simutrade.faizath.com</a> (formerly <i>simutrade.app</i>)<br>
8
+ ⚙️ <b>API:</b> <a href="https://simutrade-api.faizath.com">simutrade-api.faizath.com</a> (formerly <i>api.simutrade.app</i>)<br>
9
+ 📧 <b>Email:</b> <a href="mailto:contact@simutrade.faizath.com">contact@simutrade.faizath.com</a> (formerly <i>contact@simutrade.app</i>)<br>
10
+ 🛰️ <b>CDN:</b> <a>simutrade-cdn.faizath.com</a> (formerly <i>cdn.simutrade.app</i>)<br>
11
+ 📈 <b>Status Pages:</b> <a href="https://status.faizath.com/status/simutrade">https://status.faizath.com/status/simutrade</a> (formerly <i>status.simutrade.app</i>)
12
+ </p>
13
+ </td>
14
+ </tr>
15
+ </table>
16
+ </div>
17
+
18
+ <div align="center">
19
+ <img src="assets/logo.png" alt="Simutrade Logo" width="100%"/>
20
+ <h1 align="center">🚀 Simutrade</h1>
21
+ <h3 align="center">AI-Powered Trade Supply Chain Simulation Platform</h3>
22
+
23
+ <p align="center">
24
+ <img src="https://img.shields.io/badge/Google%20APAC%20Solutions%20Challenge-Top%2010%20Finalist-4285F4?style=for-the-badge&logo=google&logoColor=white" alt="Google APAC Solutions Challenge Top 10 Finalist"/>
25
+ </p>
26
+
27
+ <p align="center">
28
+ <a href="https://simutrade.faizath.com">🌐 Live Demo</a> •
29
+ <a href="https://simutrade-api.faizath.com">🔗 API</a> •
30
+ <a href="https://status.faizath.com/status/simutrade">📊 Status</a> •
31
+ <a href="#-competition-achievement">🏆 Achievement</a> •
32
+ <a href="#-repository-architecture">📁 Repositories</a> •
33
+ <a href="#-tech-stacks">🛠️ Tech Stack</a>
34
+ </p>
35
+ </div>
36
+
37
+ ## 🎬 Demo Video
38
+
39
+ <div align="center">
40
+ <a href="https://drive.google.com/file/d/14eXdPWHsSgBYRP-9KojyD9x7LFupAVNk/preview">
41
+ <img src="assets/demo.gif" alt="Simutrade Demo Video" width="100%"/>
42
+ </a>
43
+ <p><em>▶️ Click to watch the Simutrade demo</em></p>
44
+ </div>
45
+
46
+ ## 🌟 What is Simutrade?
47
+
48
+ **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.
49
+
50
+ ## 🏆 Competition Achievement
51
+
52
+ ### 🌏 About the Google APAC Solution Challenge 2025
53
+
54
+ The **[Google APAC Solution Challenge 2025](https://hack2skill.com/event/apacsolutionchallenge)** 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.
55
+
56
+ **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.
57
+
58
+ ### 🥇 Top 10 Finalist
59
+
60
+ **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.
61
+
62
+ <div align="center">
63
+ <img src="assets/Top_10_Google_APAC_Solutions_Challenge.webp" alt="Top 10 Google APAC Solutions Challenge" width="600"/>
64
+ <p><em>Simutrade recognized as Top 10 Finalist in Google APAC Solutions Challenge 2025</em></p>
65
+ </div>
66
+
67
+ ### 🌟 Our Journey
68
+
69
+ - **🏢 Google Philippines Office Visit**: Our team had the privilege of visiting Google's Philippines office, experiencing the innovative culture and meeting with Google engineers
70
+ - **🏛️ Asian Development Bank Presentation**: We presented Simutrade at the Asian Development Bank Headquarters, showcasing our AI-powered trade simulation platform to industry experts
71
+ - **🎯 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
72
+ - **🤝 Networking & Learning**: The experience provided invaluable networking opportunities and insights into the future of trade technology
73
+
74
+ ### 📚 Competition Resources
75
+
76
+ - **Official Competition**: [Google APAC Solution Challenge 2025](https://hack2skill.com/event/apacsolutionchallenge)
77
+ - **Archived Competition Page**: [Archive Version](https://archive.faizath.com/archive/1751469385.462976/index.html)
78
+
79
+ ### 📸 Journey Gallery
80
+
81
+ <div align="center">
82
+ <table>
83
+ <tr>
84
+ <td align="center" width="50%">
85
+ <img src="assets/Google_Philippines_Office_Visit.jpg" alt="Google Philippines Office Visit" width="100%"/>
86
+ <p><em>🏢 Our team visiting the Google Philippines Office</em></p>
87
+ </td>
88
+ <td align="center" width="50%">
89
+ <img src="assets/Team_Introduction_at_Google_Philippines_Office.jpg" alt="Team Introduction at Google Philippines Office" width="100%"/>
90
+ <p><em>👋 Team introduction at the Google Philippines Office</em></p>
91
+ </td>
92
+ </tr>
93
+ <tr>
94
+ <td align="center" width="50%">
95
+ <img src="assets/Simutrade_Booth_at_Asian_Development_Bank_HQ.jpg" alt="Simutrade Booth at Asian Development Bank HQ" width="100%"/>
96
+ <p><em>🛰️ The Simutrade booth at the Asian Development Bank HQ</em></p>
97
+ </td>
98
+ <td align="center" width="50%">
99
+ <img src="assets/Top_3_Awarding_at_Asian_Development_Bank_HQ.jpg" alt="Awarding Ceremony at Asian Development Bank HQ" width="100%"/>
100
+ <p><em>🏆 The Top 3 awarding ceremony at the Asian Development Bank HQ</em></p>
101
+ </td>
102
+ </tr>
103
+ </table>
104
+ </div>
105
+
106
+ This achievement demonstrates Simutrade's potential to revolutionize global trade simulation and its recognition by leading technology and development organizations.
107
+
108
+ ---
109
+
110
+ ## Team
111
+
112
+ <div align="center">
113
+
114
+ <table>
115
+ <tr>
116
+ <td width="220" align="center" valign="top" style="width:220px;text-align:center;vertical-align:top">
117
+ <a href="https://github.com/aththariq" style="display:inline-block">
118
+ <img src="https://github.com/aththariq.png?size=140" width="120" height="120" alt="Aththariq Lisan Qur'an Daulah Sentono" style="border-radius:50%;margin:0" />
119
+ </a>
120
+ <br /><br />
121
+ <b>Aththariq Lisan Qur'an Daulah Sentono</b><br />
122
+ Frontend Dev
123
+ <br /><br />
124
+ <a href="https://github.com/aththariq" style="display:inline-block">
125
+ <img src="assets/github.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
126
+ aththariq
127
+ </a>
128
+ <br />
129
+ <a href="https://www.linkedin.com/in/aththariqlisan/" style="display:inline-block">
130
+ <img src="assets/linkedin.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
131
+ aththariqlisan
132
+ </a>
133
+ </td>
134
+ <td width="220" align="center" valign="top" style="width:220px;text-align:center;vertical-align:top">
135
+ <a href="https://github.com/RunningPie" style="display:inline-block">
136
+ <img src="https://github.com/RunningPie.png?size=140" width="120" height="120" alt="Dama Dhananjaya Daliman" style="border-radius:50%;margin:0" />
137
+ </a>
138
+ <br /><br />
139
+ <b>Dama Dhananjaya Daliman</b><br />
140
+ ML Dev
141
+ <br /><br />
142
+ <a href="https://github.com/RunningPie" style="display:inline-block">
143
+ <img src="assets/github.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
144
+ RunningPie
145
+ </a>
146
+ <br />
147
+ <a href="https://www.linkedin.com/in/damaddaliman/" style="display:inline-block">
148
+ <img src="assets/linkedin.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
149
+ damaddaliman
150
+ </a>
151
+ </td>
152
+ <td width="220" align="center" valign="top" style="width:220px;text-align:center;vertical-align:top">
153
+ <a href="https://github.com/faizath" style="display:inline-block">
154
+ <img src="https://github.com/faizath.png?size=140" width="120" height="120" alt="Muhammad Faiz Atharrahman" style="border-radius:50%;margin:0" />
155
+ </a>
156
+ <br /><br />
157
+ <b>Muhammad Faiz Atharrahman</b><br />
158
+ Backend Dev
159
+ <br /><br />
160
+ <a href="https://github.com/faizath" style="display:inline-block">
161
+ <img src="assets/github.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
162
+ faizath
163
+ </a>
164
+ <br />
165
+ <a href="https://www.linkedin.com/in/faizath/" style="display:inline-block">
166
+ <img src="assets/linkedin.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
167
+ faizath
168
+ </a>
169
+ </td>
170
+ <td width="220" align="center" valign="top" style="width:220px;text-align:center;vertical-align:top">
171
+ <a href="https://github.com/rafidhiyaulh" style="display:inline-block">
172
+ <img src="https://github.com/rafidhiyaulh.png?size=140" width="120" height="120" alt="Muhammad Rafi Dhiyaulhaq" style="border-radius:50%;margin:0" />
173
+ </a>
174
+ <br /><br />
175
+ <b>Muhammad Rafi Dhiyaulhaq</b><br />
176
+ Project/Product Manager
177
+ <br /><br />
178
+ <a href="https://github.com/rafidhiyaulh" style="display:inline-block">
179
+ <img src="assets/github.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
180
+ rafidhiyaulh
181
+ </a>
182
+ <br />
183
+ <a href="https://www.linkedin.com/in/rafidhiyaulh/" style="display:inline-block">
184
+ <img src="assets/linkedin.svg" width="14" height="14" alt="" style="display:inline-block;vertical-align:middle;margin:0" />
185
+ rafidhiyaulh
186
+ </a>
187
+ </td>
188
+ </tr>
189
+ </table>
190
+
191
+ </div>
192
+
193
+ ---
194
+
195
+ ## 🎯 The Problem It Solves
196
+
197
+ 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?*
198
+
199
+ - **Scattered information** — routes, costs, tariffs, and logistics data live across disconnected systems and spreadsheets.
200
+ - **High barrier to entry** — professional trade-modeling tools are expensive and complex, leaving SMEs, students, and analysts underserved.
201
+ - **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.
202
+ - **Reactive, not predictive** — decisions are made without data-driven forecasting of risk, cost, and time.
203
+
204
+ ## 💡 How Simutrade Solves It
205
+
206
+ Simutrade turns trade planning into an **interactive, AI-assisted simulation** — letting anyone model, compare, and optimize a trade journey in minutes instead of weeks:
207
+
208
+ - **🤖 AI-Powered Simulation Engine** — model trade routes, costs, tariffs, and timelines and get instant, data-driven feedback on each scenario.
209
+ - **🌍 Interactive Global Maps** — visualize trade flows and supply-chain networks in real time to understand the full journey at a glance.
210
+ - **📊 Real-Time Analytics** — dashboards surface KPIs, sentiment, and trend forecasting so decisions are predictive rather than reactive.
211
+ - **💬 AI Assistant (RAG)** — a Retrieval-Augmented Generation assistant answers trade questions and recommends optimal strategies in plain language.
212
+ - **🎯 Mission-Based Strategy** — guided, goal-oriented workflows help users identify opportunities and de-risk their plans before committing.
213
+
214
+ Together these make professional-grade trade simulation **accessible, fast, and affordable** for SMEs, analysts, students, and policy makers alike.
215
+
216
+ ### ✨ Key Features
217
+
218
+ - 🤖 **AI-Powered Analysis**: Advanced machine learning algorithms for trade pattern recognition and prediction
219
+ - 🌍 **Interactive Global Maps**: Real-time visualization of trade flows and supply chain networks
220
+ - 📊 **Advanced Analytics**: Comprehensive dashboards with KPIs, sentiment analysis, and trend forecasting
221
+ - 🔄 **Real-time Simulation**: Live trade scenario modeling with instant feedback
222
+ - 🎯 **Strategic Planning**: Mission-based trading strategies and opportunity identification
223
+ - 💬 **AI Assistant**: Intelligent chat interface for trade insights and recommendations
224
+ - 📈 **Data Visualization**: Rich charts, graphs, and interactive components for data analysis
225
+
226
+ ### 🎯 Target Users
227
+
228
+ - **Trade Analysts**: Professionals analyzing global trade patterns and market trends
229
+ - **Supply Chain Managers**: Teams optimizing logistics and distribution networks
230
+ - **Business Strategists**: Decision-makers planning international expansion
231
+ - **Students & Educators**: Learning global trade dynamics through interactive simulation
232
+ - **Policy Makers**: Government officials understanding trade impact and regulations
233
+
234
+ ## 🏗️ Repository Architecture
235
+
236
+ Simutrade is built as a modular, microservices-based architecture spanning the platform, its AI service, and the dataset and model behind it:
237
+
238
+ | Repository | GitHub | Hugging Face | Deployment | Description |
239
+ |------------|--------|--------------|------------|-------------|
240
+ | 📱 **Frontend** | [simutrade-app/simutrade-fe](https://github.com/simutrade-app/simutrade-fe) | — | [simutrade.faizath.com](https://simutrade.faizath.com) | React + TypeScript interface with interactive dashboards, real-time maps, and AI-powered analytics. |
241
+ | 🔧 **API Backend** | [simutrade-app/simutrade-api](https://github.com/simutrade-app/simutrade-api) | — | [simutrade-api.faizath.com](https://simutrade-api.faizath.com) | RESTful API handling business logic, authentication, and real-time WebSocket communications. |
242
+ | 🧠 **AI & RAG Backend** | [simutrade-app/simutrade-ai](https://github.com/simutrade-app/simutrade-ai) | — | _Integrated with platform_ | RAG retrieval over trade documents using Gemini embeddings and ChromaDB. |
243
+ | 📊 **Dataset** | [simutrade-app/simutrade-rag-sft-28k](https://github.com/simutrade-app/simutrade-rag-sft-28k) | [simutrade/simutrade-rag-sft-28k](https://huggingface.co/datasets/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. |
244
+ | 🎓 **Model** | [simutrade-app/simutrade-v1-clm-rag-gemma3-4b-it-adapter](https://github.com/simutrade-app/simutrade-v1-clm-rag-gemma3-4b-it-adapter) | [simutrade/simutrade-v1-clm-rag-gemma3-4b-it-adapter](https://huggingface.co/simutrade/simutrade-v1-clm-rag-gemma3-4b-it-adapter) | _Offline / Colab_ | QLoRA adapter finetuned from `gemma-3-4b-it` on the dataset above. |
245
+
246
+
247
+ ## 📸 Screenshots
248
+
249
+ <div align="center">
250
+ <table>
251
+ <tr>
252
+ <td width="50%"><img src="assets/screenshots/1.png" width="100%"/></td>
253
+ <td width="50%"><img src="assets/screenshots/2.png" width="100%"/></td>
254
+ </tr>
255
+ <tr>
256
+ <td width="50%"><img src="assets/screenshots/3.png" width="100%"/></td>
257
+ <td width="50%"><img src="assets/screenshots/4.png" width="100%"/></td>
258
+ </tr>
259
+ <tr>
260
+ <td width="50%"><img src="assets/screenshots/5.png" width="100%"/></td>
261
+ <td width="50%"><img src="assets/screenshots/6.png" width="100%"/></td>
262
+ </tr>
263
+ <tr>
264
+ <td width="50%"><img src="assets/screenshots/7.png" width="100%"/></td>
265
+ <td width="50%"><img src="assets/screenshots/8.png" width="100%"/></td>
266
+ </tr>
267
+ <tr>
268
+ <td width="50%"><img src="assets/screenshots/9.png" width="100%"/></td>
269
+ <td width="50%"><img src="assets/screenshots/10.png" width="100%"/></td>
270
+ </tr>
271
+ <tr>
272
+ <td width="50%"><img src="assets/screenshots/11.png" width="100%"/></td>
273
+ <td width="50%"><img src="assets/screenshots/12.png" width="100%"/></td>
274
+ </tr>
275
+ <tr>
276
+ <td width="50%"><img src="assets/screenshots/13.png" width="100%"/></td>
277
+ <td width="50%"><img src="assets/screenshots/14.png" width="100%"/></td>
278
+ </tr>
279
+ <tr>
280
+ <td width="50%"><img src="assets/screenshots/15.png" width="100%"/></td>
281
+ <td width="50%"><img src="assets/screenshots/16.png" width="100%"/></td>
282
+ </tr>
283
+ <tr>
284
+ <td width="50%"><img src="assets/screenshots/17.png" width="100%"/></td>
285
+ <td width="50%"><img src="assets/screenshots/18.png" width="100%"/></td>
286
+ </tr>
287
+ <tr>
288
+ <td width="50%"><img src="assets/screenshots/19.png" width="100%"/></td>
289
+ <td width="50%"><img src="assets/screenshots/20.png" width="100%"/></td>
290
+ </tr>
291
+ <tr>
292
+ <td width="50%"><img src="assets/screenshots/21.png" width="100%"/></td>
293
+ <td width="50%"><img src="assets/screenshots/22.png" width="100%"/></td>
294
+ </tr>
295
+ <tr>
296
+ <td width="50%"><img src="assets/screenshots/23.png" width="100%"/></td>
297
+ <td width="50%"><img src="assets/screenshots/24.png" width="100%"/></td>
298
+ </tr>
299
+ </table>
300
+ </div>
301
+
302
+ ---
303
+
304
+ ## 🛠️ Tech Stacks
305
+
306
+ ### 🎨 Frontend Framework & Core
307
+ | Technology | Purpose | Description |
308
+ |------------|---------|-------------|
309
+ | **React 18** | UI Framework | Modern component-based architecture with hooks and concurrent features |
310
+ | **TypeScript** | Type Safety | Static type checking for enhanced code quality and developer experience |
311
+ | **Vite** | Build Tool | Lightning-fast development server and optimized production builds |
312
+
313
+ ### 🎨 Styling & UI Components
314
+ | Technology | Purpose | Description |
315
+ |------------|---------|-------------|
316
+ | **Tailwind CSS** | Styling | Utility-first CSS framework for rapid custom design development |
317
+ | **Radix UI** | Components | Accessible, unstyled UI primitives for building design systems |
318
+ | **Ant Design** | UI Library | Comprehensive React components with polished design resources |
319
+ | **Lucide React** | Icons | Beautiful, consistent icon library for React applications |
320
+ | **Font Awesome** | Icons | Popular scalable vector icons with React components |
321
+
322
+ ### 📊 Data Visualization & Maps
323
+ | Technology | Purpose | Description |
324
+ |------------|---------|-------------|
325
+ | **Recharts** | Charts | Composable charting library built on React and D3 |
326
+ | **Leaflet + React Leaflet** | Maps | Interactive maps with React bindings for geospatial visualization |
327
+ | **React Resizable Panels** | Layout | Flexible draggable and resizable panel layouts |
328
+
329
+ ### 🔄 State Management & Data Fetching
330
+ | Technology | Purpose | Description |
331
+ |------------|---------|-------------|
332
+ | **React Query** | Server State | Powerful data fetching, caching, and synchronization |
333
+ | **React Hook Form** | Forms | Performant form library with validation and state management |
334
+ | **Zod** | Validation | TypeScript-first schema validation for data parsing |
335
+
336
+ ### 🌐 Networking & Real-time
337
+ | Technology | Purpose | Description |
338
+ |------------|---------|-------------|
339
+ | **Axios** | HTTP Client | Promise-based HTTP client for API requests |
340
+ | **Socket.IO Client** | Real-time | Bidirectional event-based communication for live updates |
341
+
342
+ ### 🎭 Animation & Interactions
343
+ | Technology | Purpose | Description |
344
+ |------------|---------|-------------|
345
+ | **GSAP** | Animation | High-performance animation library for complex interactions |
346
+ | **Embla Carousel** | Carousel | Lightweight, touch-friendly carousel component |
347
+ | **React Day Picker** | Date Picker | Accessible date selection component |
348
+
349
+ ### 🛠️ Development Tools
350
+ | Technology | Purpose | Description |
351
+ |------------|---------|-------------|
352
+ | **ESLint** | Code Quality | Static analysis tool for finding and fixing code issues |
353
+ | **Prettier** | Code Formatting | Opinionated code formatter for consistent style |
354
+ | **PostCSS** | CSS Processing | CSS transformation with JavaScript plugins |
355
+ | **Jest** | Testing | JavaScript testing framework with React Testing Library |
356
+
357
+ ### 📦 Utility Libraries
358
+ | Technology | Purpose | Description |
359
+ |------------|---------|-------------|
360
+ | **date-fns** | Date Manipulation | Lightweight library for modern date operations |
361
+ | **React Markdown** | Content | Markdown rendering component for rich text content |
362
+ | **Sonner** | Notifications | Minimal toast notification library with animations |
363
+ | **Vaul** | Modals | Accessible modal component with better ergonomics |
364
+ | **clsx** | Styling | Utility for conditionally joining classNames |
365
+ | **React Router DOM** | Routing | Standard routing library for React navigation |
366
+
367
+ ## 🤝 Contributing
368
+
369
+ We welcome contributions from the community! Here's how you can help:
370
+
371
+ ### 🐛 Bug Reports
372
+ - Use GitHub Issues to report bugs
373
+ - Include steps to reproduce the issue
374
+ - Provide system information and error logs
375
+
376
+ ### 💡 Feature Requests
377
+ - Submit feature requests via GitHub Issues
378
+ - Describe the use case and expected behavior
379
+ - Consider the impact on existing functionality
380
+
381
+ ### 🔧 Development Setup
382
+ 1. Fork the repository
383
+ 2. Create a feature branch: `git checkout -b feature/amazing-feature`
384
+ 3. Make your changes and add tests
385
+ 4. Run the test suite: `npm test`
386
+ 5. Commit your changes: `git commit -m 'Add amazing feature'`
387
+ 6. Push to the branch: `git push origin feature/amazing-feature`
388
+ 7. Open a Pull Request
389
+
390
+ ### 📋 Code Standards
391
+ - Follow TypeScript best practices
392
+ - Use ESLint and Prettier for code formatting
393
+ - Write comprehensive tests for new features
394
+ - Update documentation as needed
395
+
396
+ ## 🏆 Acknowledgments
397
+
398
+ - **React Team** for the amazing framework
399
+ - **Vite Team** for the lightning-fast build tool
400
+ - **Tailwind CSS** for the utility-first CSS framework
401
+ - **Radix UI** for accessible component primitives
402
+ - **All Contributors** who help make Simutrade better
403
+
404
+ ## 📞 Support & Contact
405
+
406
+ - **Website**: [simutrade.faizath.com](https://simutrade.faizath.com)
407
+ - **API Documentation**: [simutrade-api.faizath.com](https://simutrade-api.faizath.com)
408
+ - **Email**: [contact@simutrade.faizath.com](mailto:contact@simutrade.faizath.com)
409
+ - **Issues**: [GitHub Issues](https://github.com/simutrade-app/simutrade-fe/issues)
410
+ - **Discussions**: [GitHub Discussions](https://github.com/simutrade-app/simutrade-fe/discussions)
411
+
412
+ ## 📝 License
413
+
414
+ This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
415
+
416
+ ---
417
+
418
+ <div align="center">
419
+ <p>Made with ❤️ by the Simutrade Team</p>
420
+ <p>
421
+ <a href="https://simutrade.faizath.com">🌐 Visit Simutrade</a> •
422
+ <a href="https://github.com/simutrade-app">👥 Our Organization</a> •
423
+ <a href="https://github.com/simutrade-app/simutrade-fe/stargazers">⭐ Star this repo</a>
424
+ </p>
425
+ </div>
profile/assets/Demo_Video_Placeholder.png ADDED

Git LFS Details

  • SHA256: a6d360a1aebd6802a070e46a69cdd8f31b1bcd4091801d9d392a186c820144a1
  • Pointer size: 132 Bytes
  • Size of remote file: 1.86 MB
profile/assets/Google_Philippines_Office_Visit.jpg ADDED

Git LFS Details

  • SHA256: 1d3a268881059d869066700f22448d09fbf0734ed059d61df659bf2202ad72ca
  • Pointer size: 132 Bytes
  • Size of remote file: 2.76 MB
profile/assets/Simutrade_Booth_at_Asian_Development_Bank_HQ.jpg ADDED

Git LFS Details

  • SHA256: dfe94a2332108a8d42b1351cd581646d947a104fa7b6ae0dff812fe2d37d153a
  • Pointer size: 131 Bytes
  • Size of remote file: 256 kB
profile/assets/Team_Introduction_at_Google_Philippines_Office.jpg ADDED

Git LFS Details

  • SHA256: 09ed97f5a6cfa3153f457cfa0bbc8519d2b57bd5673edcc518514a82ff478531
  • Pointer size: 132 Bytes
  • Size of remote file: 6.22 MB
profile/assets/Top_10_Google_APAC_Solutions_Challenge.webp ADDED

Git LFS Details

  • SHA256: 9fac267fedc1db7e5bc3b6b966ff53e54a0e4fed8343d5c5643f315d2b88ee52
  • Pointer size: 131 Bytes
  • Size of remote file: 244 kB
profile/assets/Top_3_Awarding_at_Asian_Development_Bank_HQ.jpg ADDED

Git LFS Details

  • SHA256: 1af68c19d763dbca96860771a9820b8dc108246db1e87be5cfc0c65e986ec91d
  • Pointer size: 132 Bytes
  • Size of remote file: 4.57 MB
profile/assets/demo.gif ADDED

Git LFS Details

  • SHA256: 9029515fd00b5f4f0e585e635ee9c5529ddd4cd64514fb46207d18f31db7137a
  • Pointer size: 132 Bytes
  • Size of remote file: 4.08 MB
profile/assets/github.svg ADDED
profile/assets/linkedin.svg ADDED
profile/assets/logo.png ADDED

Git LFS Details

  • SHA256: 58c30998517b403739b5091486fb29abc3c3176a138bc3dc640ff590f91da03b
  • Pointer size: 131 Bytes
  • Size of remote file: 254 kB
profile/assets/screenshots/1.png ADDED

Git LFS Details

  • SHA256: 8a64c41bbf66a7ccc58ddbeb2c16b57f29a9db90eb3024dae3d3fc1e18c567f5
  • Pointer size: 131 Bytes
  • Size of remote file: 755 kB
profile/assets/screenshots/10.png ADDED

Git LFS Details

  • SHA256: d60ce22ccf71ded4880c201ee9cb490405e447fa06bea892c0bcab2dc767f507
  • Pointer size: 131 Bytes
  • Size of remote file: 247 kB
profile/assets/screenshots/11.png ADDED

Git LFS Details

  • SHA256: 2c68c606e3e0460b013ecb0c97fae89c88ceeb304ec7497bd83ef0fcf4d51152
  • Pointer size: 131 Bytes
  • Size of remote file: 329 kB
profile/assets/screenshots/12.png ADDED

Git LFS Details

  • SHA256: 54f696b4925a29793fa79bcdc0ce3565c5ddd895a9272a41b718faed0d72df97
  • Pointer size: 131 Bytes
  • Size of remote file: 255 kB
profile/assets/screenshots/13.png ADDED

Git LFS Details

  • SHA256: 2c871561055fcfb81f4fde6cc6b041e78fde8a8d64185d1418f5183859ffbfde
  • Pointer size: 131 Bytes
  • Size of remote file: 251 kB
profile/assets/screenshots/14.png ADDED

Git LFS Details

  • SHA256: 2ff6db8073924e04fec3bd1fcb5b7bc9f63dcc03c6a998e35a9f72a9d7e55bb2
  • Pointer size: 131 Bytes
  • Size of remote file: 297 kB
profile/assets/screenshots/15.png ADDED

Git LFS Details

  • SHA256: f88cdc39af6f03a24587922031552df04429a54d523d9b9ff4f36e43c5efca31
  • Pointer size: 131 Bytes
  • Size of remote file: 353 kB
profile/assets/screenshots/16.png ADDED

Git LFS Details

  • SHA256: 5f4e36972d7d658fce3e84d3422e49d268c32a30409f0d028c7935d4d8bb2292
  • Pointer size: 131 Bytes
  • Size of remote file: 395 kB
profile/assets/screenshots/17.png ADDED

Git LFS Details

  • SHA256: a23840acf21f652db6ca8c14d4abe695eaed0a5bb096c5e2d3890f56a41dcae9
  • Pointer size: 131 Bytes
  • Size of remote file: 254 kB
profile/assets/screenshots/18.png ADDED

Git LFS Details

  • SHA256: 07a3b73fba7ae850859c79e422d7f6f02b9637c486f236ee5a79bbb17a7ed26c
  • Pointer size: 131 Bytes
  • Size of remote file: 313 kB
profile/assets/screenshots/19.png ADDED

Git LFS Details

  • SHA256: d6bf1007f75f48c6467dc0aa85c68ef1ee5748bede13677e7f1d76cbc904c159
  • Pointer size: 131 Bytes
  • Size of remote file: 493 kB
profile/assets/screenshots/2.png ADDED

Git LFS Details

  • SHA256: dc73270ebee0d459328ed9c4351e3b831ba0fc3dfbf4b17215f87c21ebb318d8
  • Pointer size: 131 Bytes
  • Size of remote file: 689 kB
profile/assets/screenshots/20.png ADDED

Git LFS Details

  • SHA256: 4cb66b98ff1dc1ad48b64d32769b2c019e4eeba370ca1dd8b7c6978e11959a51
  • Pointer size: 131 Bytes
  • Size of remote file: 587 kB
profile/assets/screenshots/21.png ADDED

Git LFS Details

  • SHA256: 05102558053c1755ed5d7881dcbc60a612203c70b3e2aea015f5ed7d4758823a
  • Pointer size: 131 Bytes
  • Size of remote file: 518 kB
profile/assets/screenshots/22.png ADDED

Git LFS Details

  • SHA256: 5a38f88af0d27977518837040d9d14e381e4f5643eb054def079db1d838cf5f1
  • Pointer size: 131 Bytes
  • Size of remote file: 306 kB
profile/assets/screenshots/23.png ADDED

Git LFS Details

  • SHA256: 4294628c9855f1b14c4e41416922d997adf988085443f7c4b272ccd6ea0b6a11
  • Pointer size: 131 Bytes
  • Size of remote file: 357 kB
profile/assets/screenshots/24.png ADDED

Git LFS Details

  • SHA256: b71ffd23fbf011c81f890b0db17c22319385dcf3005084a8a19f844e4c7958f4
  • Pointer size: 131 Bytes
  • Size of remote file: 484 kB
profile/assets/screenshots/3.png ADDED

Git LFS Details

  • SHA256: 2dc88d34202e782f392e091dea9aa6cdb4c46f520dcd9be5f734a0217812deb2
  • Pointer size: 131 Bytes
  • Size of remote file: 253 kB
profile/assets/screenshots/4.png ADDED

Git LFS Details

  • SHA256: 1b127e29373effb4818726bb442fc125234bea9f53d326b0805a13c4e59ae3a5
  • Pointer size: 131 Bytes
  • Size of remote file: 464 kB
profile/assets/screenshots/5.png ADDED

Git LFS Details

  • SHA256: d2174b08e03f24f1df889b49654b65ae0957b0221063e30c3842e8c2bb395779
  • Pointer size: 131 Bytes
  • Size of remote file: 319 kB
profile/assets/screenshots/6.png ADDED

Git LFS Details

  • SHA256: 0eba4d50709fbb8ef908c66ec8fb9785f8359f6ff196741697bcb0e737ec660b
  • Pointer size: 131 Bytes
  • Size of remote file: 425 kB
profile/assets/screenshots/7.png ADDED

Git LFS Details

  • SHA256: b470bf1409f21224bf2c132c6b3827b705ec26105076f09229955c33925ac47d
  • Pointer size: 131 Bytes
  • Size of remote file: 216 kB
profile/assets/screenshots/8.png ADDED

Git LFS Details

  • SHA256: 842ca5b9c3e520253b166d59ec71f11de10d8324f956410d7a41e4e159de88c6
  • Pointer size: 131 Bytes
  • Size of remote file: 518 kB
profile/assets/screenshots/9.png ADDED

Git LFS Details

  • SHA256: 4aa8ba1fd124db5e8ad68613152f3218a62c9b93ec5a34b5322f438333659c2a
  • Pointer size: 131 Bytes
  • Size of remote file: 234 kB