Learn Seerah Content Repository

This repository contains the structured content (primarily in Markdown/MDX format) used to generate the LearnSeerah educational resource.

Tip

🚀 New! LearnSeerah CMS is Live Easily contribute without needing GitHub knowledge! 👉 Access the CMS to add/edit Seerah content with a visual editor. All changes are securely committed via GitHub pull requests automatically through API requests.

Caution

Bengali translations are currently a work in progress and may contain errors or inconsistencies. They are not finalized.

Note

🙏 Special thanks to Khaled Tanem for his efforts in translating the Bengali content.

Bengali translations are currently under active review. We invite Bengali speakers to review the content and help improve accuracy, clarity, and readability.

To preview and help review the latest updates, visit: 👉 https://dev.learnseerah.com

If you find issues, please open an issue or submit a pull request.

---

Table of Contents

• Contents

• Contributing

  • 1. Reporting Issues
  • 2. Submitting Changes (Pull Requests)
  • 3. Alternative Submission via Email
  • 4. Branch Management
  • 5. Review Process
  • 6. Content Guidelines
  • 7. Frontend UI Translations

• Code of Conduct

---

Contents

The content within this repository is organized following this structure:

# {lang} : Language code  (e.g., en, ur, ar)
# {year} : Plain CE Year (e.g, 571, 610)
# {id}   : Integer Number of order (e.g, 1, 2)
content/
|
├── timeline-v2.json
|
├── glossary/
│   └── {lang}/
│       └── {term}.mdx
│
├── quiz/
│   └── {lang}/
│       └── {quiz-name}.mdx
│
├── references/
│   └── {lang}/
│       └── {reference}.mdx
│
├── seerah/
│   └── {lang}/
│       └── {section}.mdx
|
├── maps/
│   └── {lang}/
|       ├── storymap.geojson
│       └── areas.geojson
│
└── timeline/
    └── {lang}/
        └── {year}-event-{id}.mdx

frontend/
|
└── {lang}.json

Caution

File and folder names must follow consistent naming and structure across all languages. And MUST not contain non-ASCII characters nor any spaces and symbols, hyphens(-) can be used.

Maps are not Supported in CMS, use GeoJson.io
Frontend UI Translations are managed using GitLocalize

---

Contributing

We welcome contributions to improve and expand the Seerah content. Please follow these guidelines:

Important

Maintain a respectful and reverent tone when writing about the Prophet Muhammad (ﷺ) and related topics.

1. Reporting Issues

If you find any errors, inconsistencies, or areas for improvement:

• Open a new issue in this repository.
• Clearly describe the problem with references to file/line if applicable.

2. Submitting Changes (Pull Requests)

✅ DO:

• Create a new branch (e.g., feature/new-section-badr, fix/typo-migration).
• Follow existing .mdx examples for structure and style.
• Write clear commit messages and PR titles.
• Submit PRs to the dev branch.

🚫 DO NOT:

• Push directly to dev or production.

3. Alternative Submission via Email (If Facing Difficulties)

You may email your content to:

Address: sultan.zain004@outlook.com Subject: [LearnSeerah] New Content Request

Email Body:

Content Type: {content_type}
Content Name: {content_name}
Content: {your content here}

4. Branch Management

Branches are automatically deleted after merge to keep the repo clean.

5. Review Process

• Your PR will be reviewed and may receive feedback.
• Once approved, it will be merged into production.

6. Content Guidelines

• Accuracy — Base content on reliable Islamic sources.
• Clarity — Keep language simple and clear.
• Respect — Maintain an appropriate tone.
• Citations — Include references where necessary.

---

🌐 Frontend UI Translations

Our frontend interface is localized using GitLocalize, enabling the community to contribute translations easily.

➡️ Contribute or track progress: https://gitlocalize.com/repo/10684

---

UI Translation Progress

Language	Progress	Language	Progress
Arabic		Bengali
Chinese		French
German		Indonesian
Japanese		Korean
Malay		Pashto
Persian		Portuguese
Russian		Sindhi
Spanish		Turkish
Urdu

---

🤝 Help Translate

We welcome contributions to improve translations and add new languages.

1. Visit the GitLocalize page
2. Choose your language
3. Submit translations directly in the browser

---

📜 Code of Conduct

We follow the Contributor Covenant Code of Conduct. Please be kind, inclusive, and constructive in all interactions.

---

Contributors

Thanks to all contributors:

Thank you for supporting the LearnSeerah project!