π Waxa Website-ku Leeyahay
| Qaybta | URL | Sharaxaad |
|---|---|---|
| π Landing Page | / |
Hero section, stats, features, koorso preview, iyo CTA |
| π Koorsooyinka | /koorso |
4 koorso: 40 Cashar AI, AI Video Editing, Dropshipping AI, Resources |
| π Fasal Gaar ah | /fasal |
3 fasalood private ah: Maths, Programming, Manhajka Canada |
| π Ballan Online | /ballan |
Booking system β qabso ballan online ah |
| π¬ AI Chat | /chat |
Kaaliye AI ah oo Af-Soomaali ku hadla |
| π Knowledge Base | /kb |
Maqaallo tixraac ah oo habaysan |
| π€ Chatbot Popup | (auto) | AI popup-ka soo baxa 4 seconds kaddib |
π οΈ Tignoolajiyada La Isticmaalay (Tech Stack)
| Qaybta | Tignoolajiyada |
|---|---|
| Frontend | React 19, TypeScript, Vite, TailwindCSS, Wouter (routing) |
| Backend | Node.js, Express, tRPC |
| Database | TiDB (MySQL-compatible) via Drizzle ORM |
| Auth | Manus OAuth |
| AI/LLM | Built-in LLM (invokeLLM) |
| Deployment | PM2, Nginx, Ubuntu VPS |
π Sida Loo Install Gareeyo (Local Development)
1. Shuruudaha (Prerequisites)
Hubi in kuwan ku jiraan nidaamkaaga:
- Node.js v18 ama ka sarreeya β nodejs.org
-
npm ama pnpm β
npm install -g pnpm - Git β git-scm.com
2. Clone-garee Repo-ga
git clone https://github.com/Faratoon/isbar-si-ai.git
cd isbar-si-ai
3. Install Dependencies
npm install
4. Habeynta Environment Variables
Samee file .env oo ku jirta root directory-ga:
# Database (TiDB / MySQL)
DATABASE_URL=mysql://user:password@host:4000/dbname?ssl={"rejectUnauthorized":true}
# Manus OAuth (Authentication)
MANUS_CLIENT_ID=your_manus_client_id
MANUS_CLIENT_SECRET=your_manus_client_secret
MANUS_REDIRECT_URI=http://localhost:3001/auth/callback
# Session Secret
SESSION_SECRET=your_random_secret_key_here
# LLM (Built-in Manus LLM)
OPENAI_API_KEY=your_openai_api_key
OPENAI_API_BASE=https://api.openai.com/v1
β οΈ Xusuusin:
.envfile-ka weligaa GitHub ku push garinayso β wuxuu ku jiraa.gitignore.
5. Bilow Development Server-ka
npm run dev
Website-ka wuxuu furmayaa: http://localhost:3001
ποΈ Sida Loo Build Gareeyo (Production Build)
npm run build
Build-ka wuxuu abuuraa:
-
dist/public/β Frontend files (HTML, CSS, JS) -
dist/index.jsβ Backend server bundle
Xusuusin: Haddii RAM-ka computerkaagu yar yahay (< 1GB), build-ka ku samee computer kale oo RAM badan leh, ka dibna copy-garee
dist/folder-ka server-ka.
π Sida Loo Deploy Gareeyo (VPS Deployment)
Shuruudaha VPS-ka
- Ubuntu 20.04+
- Node.js v18+
- PM2:
npm install -g pm2 - Nginx
Tallaabada 1: Build-garee
npm run build
tar czf dist.tar.gz dist
Tallaabada 2: Copy-garee VPS-ka
scp dist.tar.gz ubuntu@your-server-ip:~/isbar-si-ai/
ssh ubuntu@your-server-ip
cd ~/isbar-si-ai && tar xzf dist.tar.gz
Tallaabada 3: PM2 ku Bilow
pm2 start ecosystem.config.cjs
pm2 save
pm2 startup
Tallaabada 4: Nginx Config
server {
listen 80;
server_name isbar-si.com www.isbar-si.com;
location / {
proxy_pass http://localhost:3001;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
sudo nginx -t && sudo systemctl reload nginx
Tallaabada 5: Domain DNS
DNS-ka domain-kaaga u habeey sidan:
A @ β your-server-ip
A www β your-server-ip
π Qaab-dhismeedka Mashruuca (Project Structure)
isbar-si-ai/
βββ client/
β βββ src/
β β βββ components/ # UI Components
β β β βββ Navbar.tsx # Navigation bar
β β β βββ ChatbotPopup.tsx # AI popup (4s auto-open)
β β β βββ AIChatBox.tsx # Chat UI component
β β β βββ WeekIcon.tsx # Icon helper
β β β βββ ui/ # shadcn/ui components
β β βββ pages/ # Bogagga website-ka
β β β βββ Home.tsx # Landing page
β β β βββ Courses.tsx # Koorsooyinka catalog
β β β βββ CourseDetail.tsx # Casharrada koorso kasta
β β β βββ PrivateFasal.tsx # Fasal Gaar ah
β β β βββ Booking.tsx # Ballan Online
β β β βββ Chat.tsx # AI Chat page
β β β βββ KnowledgeBase.tsx # Knowledge Base
β β βββ data/
β β β βββ courses.ts # Xogta 4-ta koorso
β β β βββ course.ts # Knowledge Base data
β β βββ App.tsx # Routes & layout
β βββ index.html
βββ server/
β βββ _core/ # tRPC, Auth, LLM helpers
β βββ routers/
β β βββ chat.ts # AI Chat router (system prompt)
β β βββ ...
β βββ routers.ts # Main router composition
βββ drizzle/
β βββ schema.ts # Database schema
βββ all-koorso.json # Xogta koorsooyinka (JSON source)
βββ ecosystem.config.cjs # PM2 config
βββ vite.config.ts # Vite build config
βββ package.json
π Koorsooyinka (4 Courses)
1. π₯ 40 Cashar AI (YouTube)
- 40 cashar oo ku saabsan AI, Chatbots, ManyChat, Botpress, Telegram Bots, Prompts, Canva AI, VEO 3, Linux, iyo qalab kale
- Platform: YouTube
2. π¬ AI Video Editing (Loom)
- 9 cashar oo ku saabsan AI Video Editing: InVideo, Pictory.ai, Lumen5
- Platform: Loom
3. π Dropshipping iyo Zendrop AI
- 10 cashar oo ku saabsan Zendrop, Telegram AI bots ganacsi, AI automation
- Platform: Loom
4. π Resources & Community
- 9 link oo toos ah: WhatsApp groups, Telegram channels, YouTube, Facebook, Substack
Sida loo helo casharrada: Buuxi foomka diiwaangelinta β links-ka casharrada ayaa laguugu soo diri doonaa email ahaan.
π Fasal Gaar ah (Private Classes)
Jadwalka fasalada gaarka ah β Jimce & Sabti, Waqtiga Geeska Afrika (EAT):
| Fasalka | Saacadda | Mawduucyada |
|---|---|---|
| π’ Xisaabta (Maths) | 9:00 PM β 10:15 PM | Algebra, Geometry, Calculus |
| π» Programming | 10:30 PM β 11:45 PM | Python, Logic, Mini Projects |
| π Manhajka Canada | 12:00 AM β 1:00 AM | English, Science, Social Studies |
π€ AI Chatbot Popup
- Wuxuu si toos ah u soo baxaa 4 seconds kaddib marka qofku website-ka soo galo
- Wuxuu ku salaaminayaa Af-Soomaali: "Soo dhawoow! Wax ma kaa caawin karaa?"
- Wuxuu ka jawaabaa su'aalaha AI, chatbots, koorsooyinka, iyo qorista basic-ka ah
- Wuxuu u diraa foomka diiwaangelinta marka qofku koorsooyinka weydiisto
π Xiriirrada Muhiimka ah
| Adeegga | Link |
|---|---|
| π Website (Live) | http://34.26.173.190 |
| π Diiwaangelinta | Google Form |
| πΊ YouTube | MrFaraton |
| π¬ WhatsApp | Ku biir Bulshada |
| π± Telegram | Farsamada |
| π° Substack | mfaratoon.substack.com |
| π Facebook | Soomaali Podcast |
π οΈ Amarka PM2 ee Muhiimka ah
# Xaaladda app-ka
pm2 status
# Dib u bilow
pm2 restart horn-music-app
# Logs
pm2 logs horn-music-app
# Jooji
pm2 stop horn-music-app
# Kaydi xaaladda
pm2 save
π€ Sida Loo Wax ka Bedelo (Contributing)
- Fork-garee repo-ga
- Samee branch cusub:
git checkout -b feature/magac-feature - Wax ka bedel oo commit-garee:
git commit -m "feat: sharaxaad kooban" - Push-garee:
git push origin feature/magac-feature - Pull Request fur
π Ruqsadda (License)
Β© 2025 isbar-si.com β Faratoon. Dhammaan xuquuqdu way xifdisan tahay.
π¨βπ» Macallinka
Faratoon β AI & Technology Educator
- πΊ YouTube: MrFaraton
- π± Telegram: @Farsamada
- π° Substack: mfaratoon.substack.com
- π Facebook: Soomaali Podcast
Top comments (1)
This is a meaningful project, especially because youβre making AI and programming content available in Somali. That local-language focus is probably the strongest part of the whole platform.
A few details may need clarification, though. The stack says it uses a built-in Manus LLM, while the setup asks for OpenAI API credentials. The live site is also served over plain HTTP, which is risky for a platform handling OAuth, bookings, and chat data.
I also noticed the PM2 process name is horn-music-app, which looks like a leftover from another project, and the repository invites contributions while the license says βall rights reserved.β Cleaning up those inconsistencies would make the project feel much more trustworthy and production-ready.
Still, great effort and a genuinely useful idea for the Somali developer community.