Hagaha
Contributors

Ku soo dhawoow 👋

Waad mahadsantahay xiisahaaga in aad ku biirto Ereyle! Mashruucan wuxuu ku dhisanyahay shaqada dadka badan oo xiisaynaya inay waxbarashada tiknoolojiyada ka dhigaan mid la heli karo.

Sida Loo Bilaabo

1. Fork & Clone

git clone https://github.com/YOUR-USERNAME/ereyle.com.git
cd ereyle.com
npm install
npm run dev

2. Samee Branch Cusub

Branches-ku waa inay raacaan hab-magacaabistan:

# Arrin cusub
git checkout -b feat/lesson-css-flexbox

# Bug-fix
git checkout -b fix/navbar-mobile-scroll

# Dukumiinti
git checkout -b docs/contributing-somali

3. Samee Isbeddel

npm run build   # xaqiiji dhismaha
npm run dev     # eeg si toos ah

4. Commit & Push

Raac Conventional Commits:

git commit -m "feat(lessons): add CSS flexbox lesson"
git commit -m "fix(navbar): correct mobile menu close on route change"
git commit -m "docs: update contribution guide in Somali"

5. Fur Pull Request

Fur PR GitHub-ka. Ku sharax:

• Maxaa la beddelay iyo sababta
• Screenshots haddii ay jiraan isbeddelka UI-ga
• Issue-ga uu xallinayo: Closes #42

Ku Dar Cashar Cusub

1. Dooro Koorso

Eeg src/content/courses/. Haddii aad rabto koorso cusub, fur Issue marka hore.

2. Samee Fayl MDX

# Tusaale: src/content/lessons/html-basics/6-semantics.mdx
---
title: "HTML Semantics"
description: "Baro sida loo isticmaalo tags-ka macnaha xambaarsan."
order: 6
course: "html-basics"
---

# Cinwaanka
Qoraalkaaga halkan...

3. Heerka Tayada ✅

• Casharku waa inuu leeyahay ujeeddo cad
• Tusaalooyinka koodhku waa inay shaqeeyaan
• Waa inuu taageeraa Af-Soomaali iyo Ingiriis
• Habaynta casharka (order) waa inay sax tahay
• Isticmaal <InteractiveChallenge> marka suurtagalka ah

4. Components-ka MDX

import InteractiveChallenge from '../../../components/InteractiveChallenge';
import VerifiedTutor from '../../../components/VerifiedTutor.astro';

<VerifiedTutor name="Axmed Faarax" role="Senior Dev" github="axmedfarax" />

<InteractiveChallenge
  title="Darajada"
  description="Samee X..."
  hint="Isticmaal Y..."
/>

Ku Dar Maqaal Blog

Maqaalladu waxay ku jiraan src/content/blog/. Qor fayl MDX:

---
title: "Cinwaankaaga"
description: "Sharaxaad kooban."
pubDate: 2025-06-01
author: "ereyle-team"
tags: ["JavaScript", "React"]
featured: false
---

Nuxurkaaga halkan...

Hagaha Naqshadeynta

Marka aad wax ka beddelayso UI-ga, raac nidaamkan:

Midabada

Fonts

• DM Sans — Body, UI elements
• Instrument Serif — Display headings (italic accent)
• JetBrains Mono — Code blocks

Classes la isticmaalo

<a class="btn-signal">CTA</a>
<a class="btn-ghost">Secondary</a>
<div class="card">White card</div>
<div class="card-dark">Dark card</div>
<span class="badge">Pill label</span>
<div class="sr">Scroll-reveal element</div>

• Mobile-first waa waajib — test on 375px
• Dhammaan interactive elements waa inay leeyihiin focus states
• Ha isticmaalin midabada hardcoded — isticmaal CSS variables

Hannaanka Dib-u-eegista PR

PR-kasta waxaa eegi doona xubin ka mid ah maintainers-ka gudaha 3 maalmood shaqo. Waxaan eegaynaa:

• Tayada qoraalka iyo koodhka
• Ku-dhaqanka hagaha naqshadeynta
• Mobile iyo accessibility
• SEO (meta tags, structured data)
• Adeegsiga saxda ah ee luqadda

Xiriirka

Su'aalo ma qabtaa?

• Email: hello@ereyle.com
• GitHub Discussions: github.com/ereyle/ereyle.com/discussions
• Issues: github.com/ereyle/ereyle.com/issues