π 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
Enter fullscreen mode Exit fullscreen mode
3. Install Dependencies
npm install
Enter fullscreen mode Exit fullscreen mode
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
Enter fullscreen mode Exit fullscreen mode
β οΈ Xusuusin:
.envfile-ka weligaa GitHub ku push garinayso β wuxuu ku jiraa.gitignore.
5. Bilow Development Server-ka
npm run dev
Enter fullscreen mode Exit fullscreen mode
Website-ka wuxuu furmayaa: http://localhost:3001
ποΈ Sida Loo Build Gareeyo (Production Build)
npm run build
Enter fullscreen mode Exit fullscreen mode
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
Enter fullscreen mode Exit fullscreen mode
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
Enter fullscreen mode Exit fullscreen mode
Tallaabada 3: PM2 ku Bilow
pm2 start ecosystem.config.cjs
pm2 save
pm2 startup
Enter fullscreen mode Exit fullscreen mode
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;
}
}
Enter fullscreen mode Exit fullscreen mode
sudo nginx -t && sudo systemctl reload nginx
Enter fullscreen mode Exit fullscreen mode
Tallaabada 5: Domain DNS
DNS-ka domain-kaaga u habeey sidan:
A @ β your-server-ip
A www β your-server-ip
Enter fullscreen mode Exit fullscreen mode
π 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
Enter fullscreen mode Exit fullscreen mode
π 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
π οΈ 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
Enter fullscreen mode Exit fullscreen mode
π€ 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
λ΅κΈ λ¨κΈ°κΈ°