Please sign in to access this page
Madinah Book Grammar Rules is an interactive web application built with Next.js that provides a comprehensive platform for learning Arabic grammar. The application features dynamic lessons, responsive design, and an intuitive user interface designed specifically for Arabic language learners.
xuhan
Check their projects out: Gomoku, The Unconventional Units Converter, Extract: Zombie Shooter
Once you ship this you can't edit the description of the project, but you'll be able to add more devlogs and re-ship it as you add new features!
This pull request introduces several configuration updates and documentation changes to enhance development workflows and enforce coding standards. The most important changes include adding accessibility and coding rules, updating editor settings for consistent formatting, and preserving TypeScript errors in lesson content for educational purposes.
.github/copilot-instructions.md
: Added extensive rules for accessibility and coding practices, covering ARIA attributes, semantic elements, JavaScript best practices, and TypeScript conventions. These rules aim to improve code quality and maintainability..vscode/settings.json
: Configured default formatters for multiple file types, enabled format-on-save and format-on-paste, and set up code actions for fixing issues and organizing imports using Biome and Prettier..gemini/settings.json
: Set the preferred editor to zed for a streamlined editing experience..kilocode/rules/rules.md
: Added rules to preserve TypeScript errors in lesson content, emphasizing their educational value in teaching vocabulary and grammar concepts.fix(data): align all book 1 lesson data with the authoritative schema
This commit resolves widespread schema inconsistencies found across all lesson files in src/data/vocab/book1/lessons/
. The data structures in these files did not match the authoritative TypeScript interfaces defined in src/data/vocab/vocab.ts
, leading to potential type errors and data integrity issues.
The following systematic corrections have been applied to all 23 lesson files:
Title and Description Keys: The title
and description
objects in each lesson file were updated to use the standardized ar
and en
keys, replacing the non-compliant arabic
and english
keys.
Translation Keys: The translation
object within each vocabulary item was updated to use the en
key, replacing the non-compliant english
key.
Example Keys: The objects within the examples
array for each vocabulary item were updated to use arabic
and english
keys, replacing the non-compliant ar
and en
keys.
These changes ensure that all lesson data is now type-safe and strictly conforms to the defined schema, improving maintainability and preventing future validation errors.
feat(vocab): enrich vocabulary data with examples and detailed properties
This commit introduces a comprehensive update to the vocabulary data for Book 1, significantly enhancing the learning experience.
Key changes include:
- Example Sentences: Added multiple usage examples with translations for nearly every vocabulary item across all lessons (1-23).
- Data Enrichment: Populated transliteration
, provided more detailed definition
fields, and added/refined tags
for better categorization.
- Data Structure Refactoring: Standardized language keys from ar
/en
to arabic
/english
in title
, translation
, and examples
objects for consistency.
- Corrections & Diacritics: Added missing diacritical marks to Arabic words and corrected various vocabulary items and their plural forms.
refactor(vocab): simplify lesson vocabulary data structure
Each lesson vocabulary file now exports a single lesson object directly, rather than an array containing a single object. This simplifies the data structure and makes it easier to import and consume individual lesson vocabularies.
BREAKING CHANGE: The vocabularyLists
export has been removed from lesson vocabulary files.
due to the sheer complexity and length of these vocab lists, i will be seperating them by lesson in the data/vocab directory
I am about to develop and add support for madinah book vocab
Book 1 vocab:
https://www.salafipublications.com/sps/downloads/pdf/SCL090002.pdf
book2 vocab:
https://fathiquote.wordpress.com/wp-content/uploads/2019/01/vocabulary-madinah-book02.pdf
book 3 vocab:
https://drive.usercontent.google.com/download?id=15fKIyt_w9AsZ5sZL4n1RliGLCerZAGQW&export=download&authuser=0
https://github.com/aramb-dev/madinah/blob/nextjs/vocabulary-schema-design.md