TarteelAI/quranic-universal-library
32.6
Weak · 6 November 2026
58k
lines of production code
Ruby
with JavaScript
4
measurements over time
What this system is
Features
Add Quran scripts comparison tool
Introduces a new tool for comparing Quranic text across different script traditions (Madani and Indopak). Users can select a script type, choose specific characters, and view a table of words containing those characters, with visual indicators highlighting where a character is present or missing across the selected scripts. The interface includes font size controls, copy-to-clipboard functionality, and a summary of any discrepancies found.
_app/views/quran\_scripts\comparison · high confidence
Add SplitScreen view component for side-by-side layouts
A new SplitScreen view component has been introduced to support side-by-side content presentation. This component provides a responsive layout with a left and right section, including a resize handler for adjusting the split, and is designed to facilitate the refactoring of views for mushaf layouts.
app/components · high confidence
Add grammar terms show view
A new view template for displaying individual grammar terms has been added at app/views/morphology/grammar\_terms/show.html.erb. This template renders the term's title and description, utilizing existing CSS classes for layout and styling.
_app/views/morphology/grammar\terms · high confidence
Add grid and list view templates for resources
Introduced new partials for the resources view to support both grid and list display modes. The grid view renders resource cards in a responsive column layout, while the list view presents resources in a sortable table with columns for name, description, and count, including inline SVG icons and search data attributes for both layouts.
_app/views/resources/resources\view · high confidence
Add script to convert images to WebP format
A new shell script, \scripts/2webp.sh\, has been added to automate the conversion of JPG images to the WebP format. This tool accepts source and target directory arguments, creates the output directory if necessary, and uses the \cwebp\ utility to compress images with a quality setting of 80, helping to reduce asset file sizes for the application.
scripts · high confidence
Add user project permission request form
Users can now request access to specific resources through a new form that collects their reason for the request, language proficiency, and motivation. For translation, tafsir, and chapter info resources, the form also requires an acknowledgment of the review process to ensure content integrity. Upon submission, the interface updates via Turbo Streams to refresh flash messages and remove the request button.
_app/views/user\projects · high confidence
Added SQLite benchmark script for reciter data queries
A new Ruby benchmark script has been added to the benchmark directory to measure SQLite query performance on the ayah\_timings table. The script creates a test database, inserts sample data, and compares execution times for queries with and without a composite index on reciter, surah\_number, and ayah\_number columns, demonstrating significant performance improvements when the index is applied.
benchmark · high confidence
Added export view for translation chunks and inline footnotes
The admin translation interface now includes a new export view that displays JSON-formatted data for a specific resource. This view presents two distinct formats: a 'Chunks format' generated via the Exporter::AyahTranslation service, and an 'Inline footnotes format', allowing administrators to inspect or copy these specific data structures directly from the UI.
app/views/admin/translation · high confidence
Added grid and list view templates for the Resources page
The Resources view now includes dedicated partials for displaying tools in either a responsive grid or a sortable list. The grid layout presents tool cards in a multi-column format, while the list layout provides a table-style view with columns for the tool name, description, and tags, including responsive hiding of details on smaller screens and support for sorting by name.
_app/views/tools/resources\view · high confidence
Added translation diff comparison interface
Users can now view a list of exported translations and compare them against current database records. The new index page displays each translation's status (up to date or needs export) and provides a link to a detailed diff view. The diff view highlights specific ayahs that have changed between the exported version and the current data, showing the exported text, current text, and the specific differences side-by-side.
_app/views/translation\diffs · high confidence
Ayah Topics browsing and search interface
Adds a new interface for exploring Quranic ayah topics, including an index page with search (by topic name in English/Arabic, description, or ayah number) and sorting, a detailed topic view showing hierarchical parent/child relationships, and verse cards displaying the Arabic text and translation with topic highlights. The view also includes a help section explaining the database structure and topic categories (Ontology, Thematic, General).
_app/views/resources/previews/ayah\topics · high confidence
Database schema expansion and Rails 8 upgrade
The database schema has been upgraded to Rails 8.0, introducing several new tables to support expanded content management and audio processing capabilities. New tables include \audio\_repair\_sessions\ for managing audio file repairs, \change\logs\ for tracking resource updates, \contributors\ for author information, and a suite of \downloadable\\*\ tables (\downloadable\_files\, \downloadable\_related\_resources\, \downloadable\_resource\_taggings\, \downloadable\_resource\_tags\) to handle downloadable resources and their associated tags. Additionally, \draft\_contents\ and \draft\_word\_translations\ tables have been added to support draft workflows for content and word translations. Existing tables like \downloadable\_resources\, \draft\_foot\_notes\, \draft\_tafsirs\, and \draft\_translations\ have been extended with new columns such as \language\_id\, \meta\_data\, \foot\_note\_id\, and \translation\_id\ to support these new features. The seed data has also been updated to create a super admin user.
db · high confidence
Email notifications for new and updated downloadable resources
Users will now receive email notifications when a new resource is added to QUL or when an existing resource they have downloaded is updated. The update notification specifically includes a summary of the changes (title and excerpt) with a link to the full change log, ensuring users are informed about what has changed before downloading the latest version.
_app/views/downloadable\_resource\mailer · high confidence
Expanded Morphology Admin Interface and Permission Controls
The Morphology admin section now includes dedicated management pages for new data models: DerivedWord, GrammarConcept, GrammarPattern, GrammarTermTranslation, DependencyGraph (Graph, GraphNode, GraphNodeEdge), Sentence, WordGrammarConcept, WordToken, and WordVerbForm. Existing pages (GrammarTerm, MatchingVerse, Phrase, PhraseVerse, Word, WordSegment) have been updated to use the new CMS routing namespace (\:cms\) instead of the legacy \:admin\ namespace, and their UI styling has been migrated from Bootstrap utility classes to Tailwind CSS. Additionally, action buttons for exporting CSV data and approving resources are now gated by user permissions (\can?\ checks), ensuring that only authorized users can perform these operations.
app/admin/morphology · high confidence
Group word translations and UI overhaul for word translation proofreading
The Word translation proofreading tool now supports grouping multiple words under a single shared translation. Users can create, edit, and view these group translations via a new modal interface and a dedicated column in the word list. The interface has been completely redesigned using Tailwind CSS, replacing the previous Bootstrap layout with a modern, responsive design that includes sticky table headers, improved progress tracking, and breadcrumb navigation.
_app/views/word\translations · high confidence
Initial Tajweed annotation engine for Quranic text
This change introduces the core \TajweedAnnotation\ library, providing the ability to analyze Quranic verses and apply Tajweed rules (such as Ikhafa, Ghunnah, Madda, and Qalaqah) to individual letters. The \Service\ class processes verse words into \LetterToken\ objects, determines applicable rules based on diacritics and neighboring characters, and generates HTML output with semantic classes for visualization. This enables users to view Quranic text with color-coded or styled annotations reflecting specific recitation rules.
_lib/tajweed\annotation · high confidence
Introduce Quran text search with advanced query syntax
Users can now search the Quran text via a new search interface that supports advanced query patterns, including wildcards (\*), word-count constraints ({2}, {\>2}), and anchors (^, $). The search allows for exact matching to include diacritics and an option to match across multiple ayahs for passages. Results display the selected script variant and indicate which columns matched the query.
app/views/search · high confidence
Introduce new landing page layout and components
The landing page now features a redesigned layout with a dedicated hero section, an overview of the Quranic Universal Library, and distinct sections for developer resources and tools. The new design includes a sticky header, a responsive footer with links to FAQ, Credits, Terms, and Privacy Policy, and a GitHub star button. The hero section displays the QUL logo and tagline, while the overview section highlights the project's mission to reignite the Islamic Golden Age. The resources and tools sections use a side-scrolling card layout to showcase featured items.
app/views/landing · high confidence
Introduce word mistake heatmap views for Quran page review and editing
This change adds a new set of views for the word\_mistakes feature, enabling users to visualize and edit mistake frequencies on specific Quran pages. The 'show' view renders a page preview where words with mistakes are highlighted using color and glow intensity based on their frequency, linking to a detail modal. The 'edit' view provides a form to input full-word and partial-word mistake frequencies, with a live preview of the page. Additionally, a 'word\_details' view displays specific mistake data, context, and similar words across the Quran.
_app/views/word\mistakes · high confidence
Introduces API parameter lookahead and record not found exception
This change adds new internal classes to the API layer: \Api::ParamLookahead\ and \Api::NullLookahead\ to handle parameter inspection and selection logic, and \Api::RecordNotFound\ as a custom exception inheriting from \ActiveRecord::RecordNotFound\. These components provide a structured way to evaluate API parameters and handle missing records within the API module.
lib/api · high confidence
Introduction of V1 API controller base and resource endpoints
This change introduces the foundational structure for the V1 API, starting with a new \ApiController\ base class that standardizes error handling (for missing records or parameters), caching headers, and JSON rendering. It also adds specific controllers for key resources: \Chapters\, \Verses\, \Translations\, \Tafsirs\, \Resources\, and a \Unicode\ utility endpoint. These controllers act as thin routing layers that delegate presentation logic to their respective V1 presenters, establishing the initial set of API endpoints for accessing Quranic content and metadata.
app/controllers/api/v1 · high confidence
New AI-driven Quranic grammar explanation generator
Added a new system for generating HTML explanations of Quranic grammar terms (such as POS tags and edge relations) using an AI agent. This includes a generator class that accepts English/Arabic terms and a corpus documentation link, and a prompt module that instructs the AI to produce Tailwind-styled HTML containing specific \<corpus-ayah\> and \<corpus-word\> tags for accurate, Quran-centric examples.
lib/corpus · high confidence
New Analytics dashboard and reorganized admin settings menu
Admin users now have access to a new Analytics page under Settings, providing KPIs for user growth, confirmation rates, and download trends with 12-month comparisons, alongside tables for top users and resources. The admin interface has been reorganized: the 'Api' and 'Content' menu sections have been merged into 'Settings', moving resources like API clients, slugs, and tags. Additionally, the Contributor and FAQ pages have been added to Settings, while the previous Downloadable Resource management page has been removed. The Tag resource view now groups associated resources by sub-type for easier browsing.
app/admin/settings · high confidence
New Arabic morphology tagset for Quranic text analysis
The application now includes a comprehensive set of morphological classification types for Arabic text, enabling detailed grammatical analysis of Quranic verses. This change introduces specific tagsets for Part of Speech (including 45 distinct tags for nouns, verbs, and particles), Aspect (perfect, imperfect, imperative), Case (nominative, accusative, genitive), Derivation (active/passive participles, verbal nouns), Verb Form (12 patterns), Gender, Mood, Number (singular, dual, plural), Person, Pronoun role, Segment type, Voice, and Definiteness. It also adds support for special governing word groups (kana, inna, kada) and a custom exception for unrecognized tags, providing the structural foundation for the treebank import and word-coloring features.
lib/corpus/morphology · high confidence
New Arabic text normalization and Quran-specific search capabilities
This change introduces a new Arabic text normalizer that folds Perso-Arabic letters (used in Urdu, Farsi, and Pashto) into their standard Arabic equivalents and strips diacritical marks, ensuring that search queries typed with different keyboard layouts match the stored Quranic text. It also adds a dedicated Quran search service that indexes multiple script variants (Uthmani, Imlaei, Indopak, etc.) and supports highlighting matches within the normalized text, along with a pattern parser that handles wildcards and word gaps for flexible querying.
app/services/search · high confidence
New Ayah Dependency Graphs tool with editing and comparison capabilities
A new tool for managing Ayah dependency graphs has been added, featuring an index page to filter and list verses by review status, POS tag, and edge relation. Users can view a single graph with navigation, language selection, and a side-by-side comparison mode that displays the local syntax graph alongside the Quran Corpus treebank. The tool also includes a comprehensive editor for modifying graph nodes (words, references, elided tokens, and phrases) and edges, with a live preview panel and a modal for splitting graphs across multiple verse segments.
_app/views/morphology/dependency\graphs · high confidence
New Compare Ayah tool with script and translation selection
A new 'Compare Ayah' tool has been added, allowing users to view and compare multiple Quranic verses side-by-side. Users can input specific ayah keys, select one or more translations to display alongside the Arabic text, and choose a specific script style for the Arabic rendering. The interface highlights words that appear in all selected verses to help explore similarities in wording and structure.
app/views/verses · high confidence
New NoorBayan treebank import pipeline and morphology graph editing tools
This change introduces the infrastructure to import the NoorBayan Quranic Treebank and provides new services for editing dependency graphs. The NoorBayan importer (app/services/morphology/noor\_bayan/) handles CSV ingestion, tokenization, and a ScriptAligner that maps NoorBayan's token structure to the mushaf's diacritized text, ensuring correct rendering for chapters 9-58. Additionally, new services (EdgeService, NodeService, PhraseNodeService, GraphSplitterService) enable users to add, update, and delete nodes and edges, as well as split dependency graphs within the morphology editor.
app/services/morphology · high confidence
New Quran utilities, Arabic keyboard, and PDF viewer improvements
This update introduces several new JavaScript utilities and enhances existing components in the app. A new Arabic keyboard utility (arabic\_keyboard.js) provides a virtual keyboard with custom layouts for Arabic text input. An AyahPlayer web component (ayah-player.js) enables audio playback with synchronized word highlighting and auto-scrolling, leveraging a new Segments API. Quran utility functions (quran.js) are added to handle surah and ayah ID/key conversions. The PDF viewer (pdf\_viewer.js) is refactored to support lazy loading, streaming, and callback-based initialization, improving performance and reliability. Additionally, the LocalStore key prefix is changed from 'community-' to 'qul-', and a new ScreenSize utility is introduced to detect device types (mobile, tablet, desktop, large desktop).
app/javascript/utils · high confidence
New Stimulus controllers for account forms, admin UI, and audio playback
This change introduces a suite of new Stimulus controllers in the application's JavaScript layer. The \account\_form\_controller\ adds client-side validation for password matching and conditional requirements for the current password field. The \admin\_page\_controller\ implements logic to hide the sidebar in the admin interface for non-admin users on specific actions. Several controllers (\ayah\_segment\_player\, \ayah\_boundary\, \align\_player\) enhance the audio playback experience, providing features like waveform visualization, precise seeking, and synchronized word highlighting. Additionally, new controllers manage UI interactions such as dropdowns, clipboard copying, FAQ toggling, and font previewing with glyph rendering.
app/javascript/controllers · high confidence
New Tajweed Rules tool with interactive word and letter annotation
A new Tajweed tool has been added to the application, providing users with an interactive interface to explore Quranic recitation rules. The tool features a searchable index of words with filters for specific tajweed rules, text, and regular expressions. Users can view individual words to see their Uthmani, QPC, and Digital Khatt text alongside various tajweed visualizations (including images from ReciteQuran and V4 sources). The interface includes an offcanvas sidebar for quick access to the Tajweed Rule Palette and page images, and allows for letter-level annotation where users can select and save specific tajweed rules for each character within a word.
_app/views/tajweed\words · high confidence
New Tajweed rule checks and enhanced Mushaf comparison tools
Users can now identify specific Tajweed rule applications (Iqlaab, Qalqalah, Madd al Munfasil, and Izhar) via new data integrity checks that list relevant words with visual highlights. Additionally, the existing comparison capabilities have been expanded: a new check identifies Ayahs located on different pages across two selected Mushafs, and the page comparison tool now allows users to compare the first and last words of pages between two Mushafs to spot layout discrepancies.
app/models/tools · high confidence
New V1 API finders for chapters, verses, and audio segments
This change introduces three new finder classes in the V1 API layer to support the recently added Chapters, Verses, and Segments APIs. The ChapterFinder retrieves chapter details with optimized eager loading for translated names, respecting locale preferences and falling back to English. The VerseFinder fetches verses with optional inclusion of word-level data (including translations) and multiple translation resources, allowing for rich verse displays. The SegmentFinder retrieves audio segment data for recitations, supporting both full surah and specific ayah range queries. These components provide the backend data access logic required by the new V1 API endpoints.
app/finders · high confidence
New V1 API presenters for Quranic content and resources
This change introduces a new set of API presenters in the V1 namespace to structure and serve Quranic data. The \ApiPresenter\ base class provides shared logic for handling locale-based translations, caching translated names, and validating resource IDs (such as chapters, juz, and manzil). Specific presenters expose distinct endpoints: \ChapterPresenter\ for surah listings, \VersePresenter\ for retrieving verses with configurable fields (including multiple text formats, audio URLs, and word-level details) and pagination, \TranslationPresenter\ and \TafsirPresenter\ for fetching translations and commentaries by ayah or range, and \ResourcesPresenter\ for listing available translations, recitations, and languages with associated counts. These presenters collectively enable clients to query structured Quranic content, translations, and tafsir resources with support for language filtering and eager-loaded translated names.
app/presenters/v1 · high confidence
New admin interface for managing downloadable resources
Administrators can now manage downloadable resources, files, related resources, and tags via a new ActiveAdmin section under 'Downloads'. This interface allows admins to create and edit downloadable resources (including metadata, tags, and summaries), upload and attach files to resources, link related resources, and manage resource tags with color coding. Admins can also view download statistics, refresh export data in the background, and notify users about updated resources they have previously downloaded.
app/admin/downloads · high confidence
New admin views for morphology documentation and dependency graph management
Added new admin interface components for the morphology section: a documentation page (\_docs.html.erb) explaining the linguistic data model (morphology vs. grammar), and a set of views for managing syntax graphs (\_index.html.erb, \_show.html.erb). The graph index lists available dependency graphs with stats, while the show view renders an interactive syntax graph visualization and displays detailed tables for graph nodes and edges.
app/views/admin/morphology · high confidence
New administrative rake tasks for data management and content import
This change introduces a suite of new rake tasks in lib/tasks to support data maintenance, content ingestion, and administrative workflows. Key additions include tasks for importing and managing audio segment boundaries and gaps (audio\_segments.rake, export\_boundaries.rake), auto-fixing mechanical segment issues with dry-run support (fix\_audio\_segments.rake), and importing various content types such as Bridges translations (bridges\_import.rake), Arabic topics (import\_arabic\_topics.rake), English Asbab Al-Nuzul tafsir (import\_en\_asbab\_nuzul.rake), lemmas (import\_lemmas.rake), Qaloun Quran script (import\_qaloun.rake), and subjective thematic topics (import\_subjective\_tafsir.rake). Additional tasks handle font resource creation (create\_font\_resources.rake), transliteration fixes (fix\_transliteration.rake), grammar-based mushaf generation (grammar.rake), and database cleanup (clean\_up\_old\_tables.rake, dump.rake).
lib/tasks · high confidence
New audio API controllers for recitations and segments
Added new API controllers for audio recitations and segments. The RecitationsController exposes endpoints for surah and ayah recitations and details, as well as a WAV manifest, while the SegmentsController provides endpoints for surah and ayah segments. Both controllers initialize their respective presenters (RecitationPresenter and SegmentPresenter) to handle the response logic.
app/controllers/api/v1/audio · high confidence
New audio API presenters for recitations and segment-based playback
The API now supports structured presentation of audio recitations and granular audio segments. The new \RecitationPresenter\ exposes approved recitations for specific surahs or ayahs, allows clients to request audio in different formats (defaulting to MP3 if the requested format is unavailable), and provides a WAV manifest mapping chapters to their audio parts. The new \SegmentPresenter\ enables clients to retrieve audio segments for a specific recitation and chapter, supporting pagination and range queries (via \from\ and \to\ parameters) to fetch specific portions of a surah's audio. These presenters handle validation for chapter IDs and recitation IDs, ensuring clients receive accurate, paginated segment data or appropriate errors if audio files are missing.
app/presenters/v1/audio · high confidence
New audio repair and ingestion workflow
This change introduces a new audio repair and ingestion interface for managing recitation files. It adds a tool for repairing audio by comparing source and target segments, including word-level and vowel-level corrections, and verifying that repairs are present in the exported file. It also provides a workflow for ingesting new recitations, including downloading surahs, trimming opening and closing segments, encoding to various formats, and checking for polarity issues.
_app/javascript/audio\repair · high confidence
New background jobs for audio segment export and processing
Added four new background jobs in the audio module to handle specific audio processing workflows: \ExportAudioSegmentsJob\ allows users to request audio segment exports in either SQLite or JSON formats (including per-surah gapless exports) with email notifications and issue reporting; \SplitGaplessRecitationJob\ handles the splitting of gapless recitations into individual audio files and segments, with options to create ayah recitations and detect repeated segments; \GenerateAudioFilesJob\ triggers the generation of audio files for a given recitation; and \UpdateMetaDataJob\ updates metadata for audio files. These jobs provide the backend infrastructure for exporting and managing audio segment data.
app/jobs/audio · high confidence
New change log views for tracking resource updates
Added the index, show, and item partial views for the change log feature, allowing users to browse a list of updates across QUL resources and view individual change log details. The index page displays paginated change logs with titles, dates, resource types, and associated resource links, while the show page presents the full content of a specific change log entry.
_app/views/change\logs · high confidence
New documentation system, GitHub contributors display, and topic search capabilities
This change introduces several new backend services to support new product features. The \DocsManifest\ and \DocsPageService\ classes implement a new documentation system that renders Markdown files from \app/views/docs/markdown\ into HTML, including support for code blocks, playgrounds, and internal linking, driven by a YAML manifest. The \GithubService\ fetches and caches repository contributors from the GitHub API to enable displaying GitHub contributors on the site. Additionally, the \TopicSearch\ service provides a new capability to search for Quranic topics by name, Arabic name, description, or specific verse key, with support for sorting by name, parent, or verse count.
app/services · high confidence
New downloadable resource export system with granular data formats
The \lib/exporter\ directory has been replaced with a comprehensive, modular export framework that generates downloadable resources in JSON, SQLite, CSV, DOCX, and ZIP formats. This new system introduces dedicated exporters for specific content types, including ayah translations with inline footnotes and chunked text, Quranic metadata (chapters, verses, juz, hizb), recitations with audio segments, mushaf layouts (per-page JSON and DOCX), fonts (TTF, WOFF, SVG, ligatures), and linguistic data such as qirat scripts, Quranic morphology (lemmas, stems, roots), and similar ayah matching. The \DownloadableResources\ class orchestrates these exports, allowing users to download structured, queryable datasets for offline use or integration.
lib/exporter · high confidence
New export templates for Ayah, Word, and Mushaf page views
Added new view templates in app/views/exports to support exporting individual Ayahs, Words, and Mushaf pages. The Ayah and Word templates render specific script content with configurable font families and sizes, while the Mushaf page template renders the full page layout. The Mushaf export template also includes a comprehensive UI for anomaly detection, featuring controls to filter results, a list of affected pages, and JSON output capabilities.
app/views/exports · high confidence
New gapless audio splitting capability
A new \Audio::SplitGaplessAudio\ class has been added to the \lib/audio\ directory, enabling the system to split audio recitations into individual ayah segments and surah-level files. This feature allows users to access granular audio content by downloading source audio, splitting it based on timestamp data, and organizing the output into structured directories for both individual verses and complete chapters, which are then packaged as ZIP archives.
lib/audio · high confidence
New grid and list views for resource browsing
Users can now browse resources in two distinct layouts: a responsive grid view that displays cards with tags and a list view that includes sorting, summaries, cardinality indicators, and links to related resources. Both views utilize the new Tailwind CSS styling and integrate with the existing search context to provide consistent navigation and filtering options.
_app/views/resources/resource\view · high confidence
New helper modules and UI refinements across the application
This change introduces a suite of new helper modules to support specific features and UI updates: \AnalyticHelper\ for generating event data, \DocsHelper\ for documentation styling and icons, \LearningActivityHelper\ for generating quiz logic for activities like 'Complete the Ayah' and 'Word Match', \MushafLayoutsHelper\ for sort links, \ProfilesHelper\ for profile tab and filter links, \QuranScriptHelper\ for font family mapping, \ResourcesHelper\ for downloadable resource cards, \SearchHelper\ for script labels and highlighting, \SeoHelper\ for meta tags and structured data, \TajweedHelper\ for rule options, \ToolDocsHelper\ for tool documentation content, \ToolsHelper\ for the developer tools list, and \TopicsHelper\ for topic badges. Additionally, \ActiveAdminViewHelpers\ has been updated to migrate admin routes to the CMS namespace and enforce permission checks, while \ApplicationHelper\ adds Tailwind-styled pagination, contributor credits, and utility methods.
app/helpers · high confidence
New interactive Quranic learning activities
The Learning Activities page now features four new interactive quizzes: Word Match (connecting Arabic words to translations), Complete the Ayah (fill-in-the-blanks), Surah Order (sorting or identifying adjacent surahs), and Ayah Mastery (identifying the source of a verse). These activities are presented via a new card-based grid layout and include features like reset buttons, progress tracking, and links to the Tarteel app for further memorization practice.
_app/views/learning\activities · high confidence
New interactive learning activities: Word Match, Surah Order, Fill in the Blanks, and Ayah Mastery
Users can now engage with four new interactive learning activities on the learning activities page. The Word Match activity allows users to connect related terms by clicking anchor dots, with visual feedback for correct and incorrect pairs. The Surah Order activity lets users practice the sequence of Quranic chapters through either a drag-and-drop sorting interface or a multiple-choice format. The Fill in the Blanks activity provides a drag-and-drop exercise where users place words into the correct positions within a text. Finally, the Ayah Mastery activity offers a multiple-choice quiz format for testing knowledge of specific verses. All activities include visual feedback, progress tracking, and confetti animations upon successful completion.
app/javascript/controllers/activities · high confidence
New layout data export tools for Mushaf pages and verses
Added a new \lib/layout\_exporter\ module that generates static layout data files for specific Mushaf editions. This includes exporting page-to-verse mappings (\PageLookup\), verse-level metadata and letter fractions (\AyahMetadata\), last-word location hashes for JavaScript consumption (\LastWordHash\), and page indices lookup tables supporting optional Hizb and Manzil divisions (\PageIndicesLookup\). These exports are written to \tmp/layout-data/\ as JSON or JS files, enabling frontend or other services to access pre-computed layout structures without querying the database directly.
_lib/layout\exporter · high confidence
New maintenance mode, search export, and tajweed annotation tools
This update introduces several new capabilities and refactors existing logic in the library layer. A new MaintenanceMode system allows administrators to toggle a site-wide 503 status via a flag file, with a Rack middleware handling requests, bypass tokens, and static asset access. A new ExportQuranFts library generates a SQLite database with FTS5 indexes for Surah and Ayah search, supporting Unicode and trigram tokenization. Tajweed annotation is expanded with a new TajweedRules class supporting 'old' and 'new' color schemes and rule sets, while a SpotTestPairGenerator uses OpenAI to create memorization spot-test pairs based on waqf signs. Additional changes include a Cloudflare cache clearer, an OpenAI agent wrapper, a Quran word finder, and an exported file key generator. Existing services are also updated: ExportService fixes a typo in TRANSLATION\_NAME\_MAPPING and corrects resource IDs, MatchingAyahService refactors phrase matching logic, PhraseBuilderService replaces dialectic removal with diacritic removal, and QuranWaHaditParser adds language detection for Arabic/Urdu text.
lib · high confidence
New model concerns for audio versioning, resource deletion, and slug management
This change introduces several new model concerns in the application's data layer. Audio assets now use \AudioContentVersioning\ to track content changes via file fingerprints and ETags, ensuring clients only re-download audio when the actual bytes change. Resource content deletion is now governed by \ResourceContentDestroyable\ and \RecitationDestroyable\, which enforce safety checks to prevent the removal of content still linked to recitations, translations, or user projects. Additionally, the \Slugable\ concern has been updated to support multi-locale slugs with a default flag, and new concerns \HasMetaData\, \HasVerseMapping\, and \PaperTrailAttribution\ provide standardized metadata handling, verse range scoping, and audit trail attribution respectively.
app/models/concerns · high confidence
New models and finders for draft content, morphology, and audio metadata
This change introduces a suite of new models and finders that support draft content workflows, Quranic morphology analysis, and audio metadata management. The \Draft::Content\ and \Draft::WordTranslation\ models enable a unified approve-and-import process for translations, tafsirs, and other resources, while the \V1::TafsirFinder\ and \V1::TranslationFinder\ provide structured, paginated access to approved content. Morphology support is expanded with \Morphology::DependencyGraph\ and related models to store and query grammatical structures, alongside \TajweedWord\ for recitation rules. Additionally, new audio utilities like \AudioFileMetaData\ and \GenerateAudioWavManifest\ handle metadata extraction and WAV file splitting, while models like \Book\, \Contributor\, and \ChangeLog\ enhance resource tracking and attribution.
ruby · high confidence
New morphology graph and treebank visualization presenters
Added five new presenters in the morphology module to support the new syntax graph and treebank rendering features. GraphPresenter generates the JSON payload for the main dependency graph view, including word nodes, edges, and phrase nodes with localization support. GraphEditPresenter provides data for editing the graph, including available words and segments within a verse range. GraphIndexPresenter handles navigation between multiple graphs per verse. TreebankPresenter builds the JSON payload for the client-side SVG treebank renderer, handling token positioning, dependency edges, and constituency phrase nodes. WordPresenter enhances the individual word view with navigation to previous/next words and access to the associated ayah graph.
app/presenters/morphology · high confidence
New morphology resource controllers for treebank, graphs, and linguistic data
This change introduces a suite of new controllers in the morphology area to support detailed linguistic analysis and graph editing. The TreebankController provides an index for filtering verses by root, lemma, POS tag, or relation, and a show/data endpoint to render sentence and word token details with caching. The DependencyGraphsController manages the lifecycle of dependency graphs (listing, viewing, editing, splitting) and exposes syntax graph JSON. Supporting controllers (DependencyGraphNodes, DependencyGraphEdges) handle the creation, updating, and deletion of graph nodes and edges via Turbo Streams. Additionally, dedicated show endpoints are added for GrammarTerms, Lemmas, Roots, Stems, and Words to expose specific linguistic resources.
app/controllers/morphology · high confidence
New morphology root detail page with word frequency table
Users can now view a dedicated detail page for Arabic roots, which displays the root's Arabic and English forms, its unique word count, and its total occurrences in the Quran. The page includes a scrollable table listing the specific Quranic words derived from the root, their English translations, and their frequency, sorted by occurrence count.
app/views/morphology/roots · high confidence
New profile dashboard with activity tracking and account management
Users now have a dedicated profile section to manage their account and view their activity history. The new Account Settings page allows users to update their name, bio, email, and password. The main profile dashboard displays key metrics for downloads, contributions, and resource access requests, with tabbed views that let users filter and browse their specific contribution history, download records, and pending or approved resource access requests.
app/views/profiles · high confidence
New public assets and updated site configuration
This update introduces several new public-facing resources: a dedicated font comparison tool (compare-font.html), a branded SVG favicon, a custom maintenance page, and a web app manifest for PWA support. It also removes the legacy 404 error page and the old apple-touch-icon file. Additionally, the robots.txt file has been updated to explicitly disallow crawling of the /admin path.
public · high confidence
New resource preview templates for Quranic data types
Added new preview templates in app/views/resources/previews for multiple resource types, including ayah themes, ayah topics, fonts, morphology, Mushaf layout, Mutashabihat (similar phrases), Quran metadata, Quran scripts, recitations, and surah info. Each template provides a tabbed interface with a live preview and help documentation, allowing users to interactively explore and understand the structure and content of these specific Quranic resources.
app/views/resources/previews · high confidence
New resource update notifications and updated email sender identity
Users will now receive email notifications when downloadable resources they have previously downloaded are updated, including details about the changes in the resource. Additionally, the default sender address for all system emails has been changed from [e-mail redacted] to [e-mail redacted], and the welcome email subject line has been updated to 'Welcome to QUL – JazakAllah Khair for Joining Our Community'.
app/mailers · high confidence
New word detail page with morphological segmentation and metadata
A new show view for individual words has been added to the morphology section. This page displays the word in large Arabic script, along with its meaning, transliteration, and a corpus image. It provides navigation to previous and next words, and includes links to read the associated ayah and view its dependency graph. The view also presents a detailed breakdown of the word's morphological segments, showing part-of-speech, grammar terms, and topics, as well as key metadata like lemma, stem, root, and case information, with modals available for deeper exploration of the lemma, stem, and root.
app/views/morphology/words · high confidence
NoorBayan Treebank: interactive syntax graph and I'rab table views
Users can now explore the NoorBayan Treebank through a dedicated interface that includes an interactive syntax graph and a detailed I'rab (morphological analysis) table. The new views allow browsing ayahs with previous/next navigation, filtering by POS tag, relation, root, or lemma, and switching between English, Arabic, and Urdu. The syntax graph view supports zooming, resetting, and downloading as PNG, while the I'rab section displays word-by-word morphological breakdowns with color-coded segments and links to roots or lemmas.
app/views/morphology/treebank · high confidence
Project initialization and development environment setup
The repository has been initialized with a new Ruby on Rails application structure, establishing the core development environment. This includes configuring the runtime versions (Ruby 3.3.3, Node 24.19.0), setting up the JavaScript build pipeline with esbuild and Tailwind CSS, and providing a Docker Compose configuration for local PostgreSQL and Redis services. Additionally, standard project governance files such as the MIT License, .dockerignore, and a Security Policy have been added to support the new codebase.
(repo-wide) · high confidence
Unified admin interface for reviewing and importing draft translations, tafsirs, and word translations
Administrators now have a centralized 'Drafts' section in the CMS to manage, review, and approve draft content for translations, tafsirs, and word translations. This update introduces a unified workflow where admins can view side-by-side diffs between current and draft texts, add inline footnotes to translations, and approve changes to update the live site. The interface includes specific tools for tafsir management, such as importing from SQLite databases, cloning items, and reprocessing text formatting. Additionally, the admin navigation has been standardized from 'admin' to 'cms' across all draft resources, and sidebar widgets now provide real-time statistics on import progress, matched counts, and pending issues for each resource.
app/admin/draft · high confidence
Removals
Removal of custom numeric range filter input
The custom \FilterNumericRangeInput\ component, previously located in \lib/active\_admin/numeraic\_range.rb\, has been removed from the codebase. This change eliminates the specific implementation that rendered numeric range filters using separate 'greater than or equal to' and 'less than or equal to' text fields, meaning users will no longer have access to this specific filter UI pattern unless it is re-implemented elsewhere.
_lib/active\admin · high confidence
Removal of legacy CMS download pages and Arabic language utilities
The application no longer provides the 'Tarteel CMS' download interface, as the \app/views/downloads/index.html.erb\ and \show.html.erb\ templates have been deleted. Additionally, several internal utilities for Arabic text processing and Urdu transliteration have been removed, including \lib/utils/arabic/harf.rb\, \lib/utils/arabic/letters/qpc\_hafs.rb\, \lib/utils/arabic/rules.rb\, \lib/utils/arabic/letters/letter.rb\, \lib/utils/arabic/letters/tajweed.java\, and \lib/utils/lang/urdu\_transliterator.rb\.
app/views/downloads, lib/utils/arabic, lib/utils/lang · high confidence
Removed Quran Word-by-Word proofreading views
The edit, index, and show views for the Quran Word-by-Word (wbw\_texts) proofreading interface have been deleted. This removes the ability for users to filter, view, and edit word-level text data (Indopak, Uthmani, Imlaei, and KFQC Hafs) through the web interface.
_app/views/wbw\texts · high confidence
Removed QuranEnc draft approval and update-checking background jobs
The \ApproveDraftTranslationJob\ and \UpdatesCheckerJob\ classes have been removed from the application. This eliminates the automated background processes that previously handled the approval of draft translations and tafsirs, as well as the periodic checking for new or updated translations from the QuranEnc source. Administrators will no longer receive automatic notifications or todo items for these specific QuranEnc import workflows via these jobs.
_app/jobs/quran\enc · high confidence
Removed internal audio optimization rake tasks
The \lib/internal/audio\_optimize.rake\ file has been deleted, removing internal rake tasks that previously handled audio volume normalization, format conversion (MP3/Opus), and segment timing imports for audio recitations. This cleanup removes the local tooling used to process and optimize streaming audio assets.
lib/internal · high confidence
Behavioural changes
10 commits (2 fixes) modifying app/views/resources/previews/quran\_metadata
A change to existing behaviour in app/views/resources/previews/quran\_metadata — 10 commits (2 fixs), 9 files: “Add "How to use this resource" to the quran-metadata Help tabs (\#893)”; “Replaced bootstraps classes in app with tailwind (\#395)”; “Improve docs UI (\#784)”; and 7 more (refs \#893, \#395, \#784, \#683, \#593, …).
_app/views/resources/previews/quran\metadata · medium confidence · unverified
18 commits (1 fix) modifying app/views/docs
A change to existing behaviour in app/views/docs — 18 commits (1 fix), 7 files: “add styling for documentaiton”; “more patches”; “Gapless segments (\#407)”; and 15 more (refs \#407, \#159, \#395, \#811, \#593, …).
app/views/docs · medium confidence · unverified
2 commits (0 fixes) modifying app/services/mutashabihat
A change to existing behaviour in app/services/mutashabihat — 2 commits, 10 files: “Improve the Mutashabihat tool (\#922)”; “Show how each ayah differs from its Mutashabihat phrase (\#925)” (refs \#922, \#925).
app/services/mutashabihat · medium confidence · unverified
2 commits (0 fixes) modifying app/views/resources/docs
A change to existing behaviour in app/views/resources/docs — 2 commits, 32 files: “Add Preview, Docs and Licence tabs to resource pages (\#943)”; “fix typo in \ayah\_theme\ docs (\#967)” (refs \#943, \#967).
app/views/resources/docs · medium confidence · unverified
2 commits (0 fixes) modifying docker/dev
A change to existing behaviour in docker/dev — 2 commits, 1 file: “Add docker-compose for dev environment setup (\#561)”; “Update db config for new database (\#988)” (refs \#561, \#988).
docker/dev · medium confidence · unverified
2 commits (1 fix) modifying (repo-wide)
A change to existing behaviour in (repo-wide) — 2 commits (1 fix), 25 files: “Show fixes waiting for review on the tool pages (\#974)”; “Give the proofreading tools simple names (\#973)” (refs \#974, \#973).
(repo-wide) · medium confidence · unverified
26 commits (4 fixes) modifying app/views/tafsir\_proofreadings
A change to existing behaviour in app/views/tafsir\_proofreadings — 26 commits (4 fixs), 3 files: “Apply sticky table header only for desktop screens to avoid mobile layout issues on all tools pages (\#343)”; “Add shared pagination partial and use it across tool views (\#591)”; “Replaced bootstraps classes in app with tailwind (\#395)”; and 23 more (refs \#343, \#591, \#395, \#949, \#158, …).
_app/views/tafsir\proofreadings · medium confidence · unverified
3 commits (0 fixes) modifying app/services/draft
A change to existing behaviour in app/services/draft — 3 commits, 4 files: “Improve tafsir, translation and transliteration proofreading (\#923)”; “Import/export draft tafsir content (\#762)”; “Reviewer comments on drafts (\#936)” (refs \#923, \#762, \#936).
app/services/draft · medium confidence · unverified
3 commits (0 fixes) modifying app/views/admin/draft
A change to existing behaviour in app/views/admin/draft — 3 commits, 2 files: “Transliteration draft review (\#918)”; “Surah info drafts (\#934)”; “Tools improvements (\#673)” (refs \#918, \#934, \#673).
app/views/admin/draft · medium confidence · unverified
5 commits (0 fixes) modifying app/services/audio
A change to existing behaviour in app/services/audio — 5 commits, 5 files: “don't close the validaiton modal when user click issue and add more metadata segments issues (\#696)”; “Add a tool to cut ayah audio from gapless surah audio (\#966)”; “Shared segment validator (\#661)”; and 2 more (refs \#696, \#966, \#661, \#841, \#689).
app/services/audio · medium confidence · unverified
5 commits (0 fixes) modifying config/environments
A change to existing behaviour in config/environments — 5 commits, 2 files: “Transliteration draft review (\#918)”; “Add deploy pipeline (\#582)”; “upgrade to ruby 3.3”; and 1 more (refs \#918, \#582).
config/environments · medium confidence · unverified
6 commits (2 fixes) modifying docker
A change to existing behaviour in docker — 6 commits (2 fixs), 4 files: “fixed the host name”; “rollbac to ruby 3.0.5”; “Allow uploading zipped db (\#336)”; and 3 more (refs \#336, \#603).
docker · medium confidence · unverified
63 commits (14 fixes) modifying app/presenters
A change to existing behaviour in app/presenters — 63 commits (14 fixs), 37 files: “fix ayah key”; “Compare audio help and tool layout (\#930)”; “User menu (\#662)”; and 60 more (refs \#930, \#662, \#982, \#918, \#486, …).
app/presenters · medium confidence · unverified
Admin UI overhaul and new CMS content management tools
The admin interface has been migrated from Bootstrap to Tailwind CSS, updating the styling of existing forms, modals, and validation views (such as segment and tafsir validation) to use modern utility classes and a cleaner layout. This change also introduces a suite of new administrative capabilities for managing CMS content: admins can now compare draft and current tafsir ayah groupings, export and import draft tafsir and translation content, split audio recitations into individual ayah segments, and export various data types (audio segments, mushaf layouts, words) to SQLite or JSON formats. Additionally, the system now supports refreshing downloadable resources with an option to notify users via email, and the admin navigation and action paths have been standardized under the new 'cms' namespace.
app/views/admin · high confidence
Admin UI styling refinements and layout adjustments
The admin interface receives several visual and structural updates: the ActiveAdmin overrides file is cleaned up with consistent spacing, buttons are forced to wrap text properly, and visited link colors are preserved. The modal body padding is explicitly defined on all four sides to ensure consistent spacing. Additionally, the site title styling is replaced with a CSS filter to invert and recolor the logo image, and a new rule ensures the main content wrapper in the mushaf page preview uses flexbox for better layout control.
app/assets/stylesheets/admin · high confidence
Admin access restructured and legacy models removed
The application's admin authentication and authorization have been refactored: the legacy \AdminUser\ model has been removed in favor of the standard \User\ model, and the \Ability\ class now uses \is\_admin?\, \is\_moderator?\, and \is\_normal\_user?\ checks to define permissions. This change introduces granular access controls, such as restricting normal users from viewing sensitive admin data (e.g., \Feedback\, \AdminTodo\) and granting admins specific capabilities like managing \ChangeLog\ and \Faq\ entries. Additionally, several unused or legacy models (\ContactMessage\, \WbwText\, \WbwTranslation\, \WordLemma\, \WordStem\) have been deleted, while a new \QuranScript\ module was added to define a table name prefix.
app/models · high confidence
Admin interface rebranding, Tailwind CSS integration, and Rails 8 migration cleanup
The admin interface has been rebranded from 'Tarteel' to 'Tarteel QUL' and migrated to the ':cms' namespace, updating authentication to use standard user methods instead of admin-specific ones. The UI now utilizes Tailwind CSS instead of Bootstrap, with legacy framework default initializers (Rails 5.0–7.0) and the CarrierWave storage initializer removed to reflect the upgrade to Rails 8 and the shift away from CarrierWave. Sentry error reporting has been updated with a new configuration file replacing the deprecated Raven gem, and PaperTrail has been patched to support Active Admin filters.
config/initializers · high confidence
Admin interface restructured under Content namespace with CMS routing and new content management tools
The admin interface has been reorganized by moving content-related resources (such as translations, tafsir, footnotes, and chapter info) into the app/admin/content directory and updating their menu paths to use the 'cms' namespace instead of 'admin'. This change introduces new admin pages for Arabic transliteration, change logs, and root details, while enhancing the translation and tafsir views with features like archived status filtering, footnote display, and export data viewing. Additionally, the ResourceContent page now supports scoped filtering for downloadable resources and includes new member actions for comparing ayah grouping and importing draft tafsir content, all secured with explicit authorization checks.
app/admin/content · high confidence
Admin interface updates for raw data management
The admin interface for raw data has been updated to improve usability and consistency. Navigation links for ayah data previews now point to the CMS section instead of the admin section, and the 'View record' link has been similarly redirected. The Ayah Record resource now includes a dedicated form for editing content details, allowing users to select verses and resources via searchable selects and edit text fields, including a rich-text editor for cleaned text. The Resource resource also gains a form for editing details, featuring a searchable select for resource content and a JSON editor for metadata.
_app/admin/raw\data · high confidence
Admin panel overhaul: new Tajweed and Script resources, CMS routing, and expanded Quran data fields
The admin interface for Quran content has been significantly expanded and reorganized. New resources have been added to manage Tajweed annotations (\TajweedWord\) and Quranic scripts by verse and word (\QuranScript::ByVerse\, \QuranScript::ByWord\), providing dedicated views for these specific data types. The navigation structure has shifted, with many internal links and preview actions moving from the \/admin\ namespace to \/cms\, reflecting a broader rebranding or structural change. Existing resources like \Chapter\, \Mushaf\, \Verse\, and \Word\ have been enhanced with new editable fields, including various script variants (Digital Khatt, Indopak Misbah, Indonesian Sign Language), Tajweed-specific text fields, and metadata columns. Additionally, the \Mushaf\ resource now includes debugging tools for line counts and a new action to export SQLite database layouts.
app/admin/quran · high confidence
Admin panel renamed to CMS with enhanced audio management capabilities
The admin interface has been renamed to CMS, with all internal navigation paths and links updated from /admin to /cms. This update significantly expands audio management features: administrators can now clone recitations, generate gapped audio from gapless sources, and upload segment data. The audio file and recitation views now display additional metadata such as word counts, segment counts, file sizes, and bit rates, and support filtering by these new fields. Access to critical actions like segment validation, metadata refresh, and audio generation is now strictly gated by user permissions. Additionally, the reciter bio field now uses a safe HTML helper to prevent XSS vulnerabilities, and the UI has been refined with wider modals and improved duration formatting.
app/admin/audio · high confidence
Animated shard ring now uses WebGL rendering
The animated shard ring in the UI now renders using WebGL instead of the previous Spline-based approach. This change introduces a custom renderer that draws the 16-chip ring with shadow-mapped spot lights and a Kawase bloom pass, providing a more performant and native graphics experience. The implementation includes robust fallbacks for browsers without WebGL support, respects user preferences for reduced motion, and optimizes performance by pausing rendering when the animation is off-screen or the tab is inactive.
app/javascript/shards · high confidence
Arabic/Urdu Transliterations UI modernized with Tailwind CSS and new preview component
The Arabic/Urdu Transliterations tool views have been redesigned to use Tailwind CSS instead of Bootstrap, resulting in a more responsive layout with sticky table headers and updated progress bars. A new \\_ayah\_preview\ partial has been introduced to display word-by-word transliterations with continuous-word grouping, and the \new\ and \show\ pages now feature a zoomable image editor for page navigation. Additionally, the \proof\_read\_comments\ modal has been removed, and the \index\ page now uses a shared pagination component.
_app/views/arabic\transliterations · high confidence
Ayah view restructured into a modal with tabbed content and dynamic selectors
The Ayah display has been refactored into a modal interface that organizes content into tabs for Ayah text, Translations, Tafsirs, Words, Theme, Transliteration, Topics, and Recitation. This update introduces interactive side-panel selectors for each section, allowing users to dynamically change the Arabic script, reciter, translation, tafsir, or word-by-word translation without reloading the page. The layout now features a dedicated header for navigation and a loading indicator for asynchronous content updates.
app/views/ayah · high confidence
Controller architecture refactored to use presenters and unified authorization
The application's controller layer has been restructured to improve separation of concerns and security. All controllers now delegate data preparation and view logic to dedicated Presenter objects (e.g., AyahPresenter, ResourcesPresenter), removing complex logic from the controllers themselves. A unified authorization pattern has been introduced, replacing individual \check\_permission\ methods with a consistent \authorize\_access!\ callback that handles permission denials for both standard and Turbo/JSON requests. Additionally, sorting and pagination parameters are now normalized through shared base controller methods, and several legacy controllers (Downloads, ProofReadComments, WbwTexts) have been removed or replaced by new, more specific controllers for features like Tajweed, Script Comparison, and Learning Activities.
app/controllers · high confidence
Database backup exports now support binary format and ActiveStorage uploads
The database backup utility in lib/utils/db\_backup.rb now allows exporting dumps in binary format (via the new \binary\ option) in addition to the existing SQL text format. Backups are now attached to the application using ActiveStorage instead of raw file paths, and the backup process logs the executed commands. The utility also refactors database configuration handling to use \compact\_blank\ for cleaner environment variable merging. Other changes in this location include renaming the CSV-to-SQLite3 utility to the Utils module, simplifying the text formatter to strip whitespace and double spaces, and fixing the Sidekiq start script to run in the foreground.
lib/utils · high confidence
Database schema overhaul for new features and data structures
This update applies a comprehensive set of database migrations to support new product capabilities and refactor existing data models. Key additions include tables for downloadable resources and user downloads, a new FAQ system, and support for Tajweed annotations and multiple Quranic scripts (Digital Khatt, Indopak Misbah). The schema also introduces a dependency graph for morphological analysis, a contributor system, and detailed tracking for audio files and recitations. Existing structures have been refined by adding metadata fields, renaming columns for clarity, and dropping obsolete tables to streamline the data layer.
db/migrate · high confidence
Enhanced data integrity check interface with Tajweed support and improved result display
The Data Integrity Check tool in the admin panel now supports Tajweed rule validation checks alongside existing data integrity checks, allowing administrators to verify Tajweed-specific data consistency. The results display has been improved to show usage instructions, error messages, and summary statistics (such as counts) alongside the main data table, providing clearer feedback on check outcomes and better visibility into the data being validated.
app/admin/tools · high confidence
Enhanced local development setup and new Docker entrypoint
The local development experience is improved with a more robust setup script that now automatically installs Yarn dependencies and creates all required databases (including the separate Quran content database) before preparing the environment. The development server script (bin/dev) has been updated to use the POSIX shell, defaults to port 3000, and enables lazy remote debugging. Additionally, a new Docker entrypoint script is introduced to handle container initialization, and a dedicated script for starting Sidekiq is added to streamline background job processing.
bin · high confidence
Enhanced segment editing, comparison, and auto-save capabilities
The segments store now supports comparing multiple recitation or edited segment sources using distinct color coding, with normalized data handling to ensure stable comparisons across different data types. A new auto-save mechanism debounces rapid edits (such as time tracking or nudges) to persist changes after 800ms of inactivity, while also introducing undo/redo stacks for segment modifications. Additionally, the store manages state for letter highlighting batches, timeline visibility, and play ranges, providing a more robust foundation for segment validation and editing workflows.
app/javascript/segments/store · high confidence
Export jobs now support chunked translations, mushaf layouts, and data validation
The export system has been updated to include a new Mushaf Layout export job and significant improvements to existing translation and tafsir exports. Translation exports now use a chunked format (inline footnotes and formatting) instead of the previous nested array structure, and blank footnotes are no longer included in the output. Tafsir exports now archive duplicate entries rather than removing them, group ayahs correctly, and include a validation step that generates an issues report for any missing text or group mismatches. Additionally, all export jobs have been refactored to use the standard User model for notifications instead of AdminUser, and the Tafsir and Raw Tafsir jobs now exclude archived content from exports.
app/jobs/export · high confidence
Grammar admin panel: removed word association pages and added lemma translations
The admin interface for the Grammar section has been restructured: the WordLemma, WordRoot, and WordStem management pages have been removed, while the Lemma page now supports English translations (displayed in index and show views) and links to CMS paths instead of admin paths. The Root page has been restricted to read-only access (index and show only) and now supports lookup by value string, while Stem and Verse-related pages have had their permitted parameters and filters updated to include text\_madani and other fields.
app/admin/grammar · high confidence
Improved Arabic text language detection and expanded styling classes
The text sanitizer now uses a more robust language detection process for Arabic content by stripping punctuation and symbols before analysis, iterating through multiple language detectors, and accepting results based on a configurable language mapping (e.g., accepting Arabic or English for Arabic resources). Additionally, the base scrubber now allows 'indopak-nastaleeq', 'ayah-ref', 'hlt', and 'gray' CSS classes, and the Tafsir sanitizer accepts a 'resource\_language' parameter to support these language-aware detection rules.
_lib/utils/text\sanitizer · high confidence
Improved resource search and Quran reference matching
The resource search functionality now supports parsing Quranic references (e.g., 'Surah 2:255' or 'Al-Baqarah 255') to filter results by specific verses. This change introduces a new \QuranReferenceParser\ service that handles numeric and named surah matching with normalization and fuzzy logic, and updates the \SearchQuery\ service to integrate this parsing, allowing users to find resources relevant to a specific Quranic verse directly through the search interface.
app/services/resources · high confidence
Major UI overhaul and new shared components
The application has been migrated from Bootstrap to Tailwind CSS, replacing the legacy navigation, flash notices, and form error styles with modern, responsive utility classes. This change introduces a suite of new shared partials to enhance the user experience: a dedicated SVG-based Mushaf viewer with interactive customization tools (highlighting, diacritics, search), a unified resource embed viewer supporting PDF, image, and archive views, and a new 404 page featuring interactive learning activities. Additionally, the navigation bar has been updated to reflect the 'Tarteel QUL' branding, and the site now includes shared components for pagination, breadcrumbs, and advanced filtering by Juz, page, surah, and ayah.
app/views/shared · high confidence
Migrate styling infrastructure to Tailwind CSS and modularize SCSS
The application's styling system has been overhauled to integrate Tailwind CSS as the primary utility framework, replacing the previous Bootstrap-centric approach. A new \application.tailwind.css\ file establishes the Tailwind layers and defines custom component classes for documentation (\qul-docs\, \tw-docs\), buttons, and interactive elements like code playgrounds. The existing SCSS architecture has been modularized: \application.scss\ now imports specific component styles (e.g., \components/resources\, \components/quiz\, \components/mushaf\_pages\_table\) and shared utilities, while dedicated entry points like \landing.scss\ and \export.scss\ handle specific page requirements. This change improves maintainability by reducing inline utility classes and standardizing visual components across the public site and admin interface.
app/assets/stylesheets · high confidence
Migrate tooltips from Bootstrap to Stimulus and add charting support
The application no longer relies on Bootstrap for UI components; instead, tooltips are now handled via Stimulus controllers (data-controller='tooltip') rather than manual jQuery/Bootstrap initialization, and a new utility for an ayah player has been added to the main entry point. Additionally, the Active Admin interface now includes Chart.js support via the chartkick library.
app/javascript · high confidence
Mushaf layout builder redesigned with split-screen views and guided workflow
The Mushaf layout builder interface has been completely overhauled to improve usability and clarity. The previous inline PDF viewer and resizable panes have been replaced with a consistent SplitScreen component across all editing modes (page mapping, line alignment, proofreading, and comparison), providing a stable side-by-side view of the source PDF and the layout being edited. A new guided workflow is now enforced: users must explicitly set the Ayah Range before mapping words or fixing alignment, with clear status indicators and a 'missing data' helper view explaining the required steps. The main pages table now features a visual progress tracker for each page (Ayah Range, Word Mapping, Line Alignment), a search bar to filter by page number or ayah, and a sticky header for easier navigation. Additionally, a new 'Compare with' feature allows users to view two mushafs side-by-side to check alignment differences.
_app/views/mushaf\layouts · high confidence
Mushaf rendering overhaul: new font CDN, Tajweed color-coding, and UI polish
This change updates the shared stylesheet layer to support a new font CDN (static-cdn.tarteel.ai) and asset versioning, introducing new font families for QPC recitations (Hafs, Douri, Qaloun, Shuba, Sousi, Warsh), Surah names (v1–v4 and header), and Sign Language. It adds comprehensive Tajweed annotation styles with distinct color-coding for rules like Izhar, Ikhafa, Madda, and Ghunnah, including hover effects, and introduces a new \tajweed\_color\_new.scss\ for these visual rules. The diff also refactors the content layout by centering Aya text within the Mushaf page, adding support for English text direction (LTR), and implementing word-level mistake highlighting with hover scaling. Additionally, it cleans up legacy font definitions, removes unused CSS, and updates variable definitions for colors and breakpoints to align with the new design system.
app/assets/stylesheets/shared · high confidence
New component styles and UI polish for learning tools and resources
This update introduces dedicated stylesheets for several new and existing interface components, enhancing the visual consistency and interactivity of the application. New styles have been added for the Credits page, FAQ section, Proofreading view, Quiz interface, Resources library, Segment audio player, Syntax Graph, Tajweed rules viewer, Tools help documentation, Transliteration display, Treebank visualization, Treebank editor, and Word Match exercises. Additionally, the Mushaf pages table and Download page have received styling updates. Existing components like the splash screen, common utilities, and page wrappers have been refined with improved grid layouts, responsive adjustments, and corrected callout border colors to ensure a more polished user experience across these specific areas.
app/assets/stylesheets/components · high confidence
New landing page styling system with custom components
The landing page now uses a dedicated set of SCSS stylesheets to define its visual appearance, replacing previous inline or framework-specific overrides. This includes custom button styles (such as \.btn-dark\ with hover effects), responsive tool cards with background images and overlays, a horizontal scrolling container for tools, custom tab navigation, and specific styling for Devise authentication pages and breadcrumbs. A new font face ('Open Sauce Sans') is also loaded for the landing page.
_app/assets/stylesheets/landing\page · high confidence
New lemma and stem detail views with Tailwind CSS styling
The morphology section now features dedicated detail views for individual lemmas and stems. These new pages display a summary of unique word forms and total Quranic occurrences, followed by a scrollable table listing each word form, its translation, and occurrence count. The views have been styled using Tailwind CSS utilities, replacing previous Bootstrap classes to align with the application's new design system.
app/views/morphology/lemmas, app/views/morphology/stems · high confidence
QUL Shards animation now uses WebGL
The QUL Shards visual effect in the public shards section has been replaced with a new implementation that renders the animation using WebGL. This change introduces hardware-accelerated 3D rendering with custom shaders, shadow mapping, and bloom effects to display the chip mesh and lighting scene previously defined in the Spline export data.
public/shards · high confidence
Rails 8 upgrade and comprehensive configuration restructuring
The application has been upgraded to Rails 8, introducing new configuration defaults and security settings such as stricter YAML column permitted classes and timezone preservation. To support this upgrade and improve deployment flexibility, database connection details (host, port, credentials) are now driven by environment variables rather than being hardcoded. Storage configuration has been expanded to support multiple S3-compatible endpoints for distinct use cases including exports, segments, and database backups, with improved handling of custom endpoints. Additionally, the routing structure has been significantly reorganized to expose new API namespaces for morphology, audio, and resources, while legacy admin paths are permanently redirected to the new CMS interface.
config · high confidence
Rebrand admin panel to QUL CMS and introduce UloomContent management
The admin panel has been rebranded to QUL CMS, with all internal routes, menu labels, and navigation links updated from the 'admin' namespace to 'cms'. A new UloomContent resource has been added to the Content section, allowing administrators to manage Quranic exegesis content with fields for text, cardinality, and location. The dashboard now displays a welcome message, restricts certain actions based on user permissions, and includes a new Tajweed rules section. Additionally, the previous AdminUser resource has been removed, and the User resource now supports role-based filtering and password visibility toggles.
app/admin · high confidence
Redesign Ayah Recitations tool with Tailwind CSS and segment comparison
The Ayah Recitations management interface has been redesigned to use Tailwind CSS, replacing the previous Bootstrap layout with a responsive, mobile-friendly design. The index view now features a sticky table header for easier navigation and a visual progress bar for segment processing status. The segment builder tool has been enhanced to support comparing recitation segments against raw segments, and the UI now includes breadcrumb navigation and consistent action buttons across the recitation management pages.
_app/views/ayah\_audio\files · high confidence
Redesign of Quran Script Proofreading tool with expanded script support
The Quran script proofreading interface has been redesigned to improve usability and expand script coverage. The layout now uses a shared tools header with breadcrumbs and a sticky table header for better navigation. The filter section has been simplified, replacing individual dropdowns with a shared partial and adding a 'Clear' button. The main table now displays a list of ayahs with a new 'Ayah\#' column and uses a shared pagination component. Crucially, the detailed view now supports a significantly wider range of scripts, adding Uthmani Simple, Imlaei, Imlaei Simple, Digital Khatt v1, Digital Khatt Indopak, Sign language, and Misbah script sections alongside existing ones like QPC Nastaleeq and Indopak.
_app/views/word\_text\proofreadings · high confidence
Redesigned Mutashabihat tool interface with Tailwind CSS and CMS integration
The Mutashabihat (phrase morphology) tool views have been completely restyled using Tailwind CSS, replacing the previous Bootstrap-based layout with a modern, responsive design. This update introduces a new header component, refined filter and phrase-list tables with sticky headers, and an enhanced phrase builder with improved word-selection interactions. Additionally, administrative links have been updated to point to the new CMS paths (e.g., /cms/morphology\_phrase\_verses), and the foot notes view now uses a safe\_html helper to prevent raw HTML injection.
_app/views/morphology\phrases · high confidence
Redesigned authentication and email templates with Tailwind CSS and modern UX
The authentication interface (sign-in, sign-up, password reset, account confirmation, and unlock) has been completely restyled using Tailwind CSS, replacing the previous Bootstrap-based layout. Forms now feature floating labels, inline validation feedback, and a consistent two-column layout with a decorative visual panel on the left. The sign-in and sign-up pages include a tabbed navigation to switch between login and registration. Additionally, the email templates for account confirmation, password reset, and unlock instructions have been updated with a more professional design, including a branded greeting, clearer call-to-action buttons, and improved readability.
app/views/devise · high confidence
Redesigned card components with Tailwind CSS and new layout structures
The card display system has been completely overhauled to use Tailwind CSS, introducing new partials for the card container, grid, and side-scrolling layouts. This change standardizes the visual appearance across the application, ensuring consistent spacing, typography, and responsive behavior for resource cards. New components handle specific card elements like titles, descriptions, tags, and footers, while a new download dropdown component manages resource file access and copyright restrictions. The update also includes a 'Learn More' button component and improves the overall structure of card content, including support for Quran script previews and icon displays.
app/views/card · high confidence
Redesigned community pages with Tailwind CSS and new interactive tools
The community section has been completely restyled using Tailwind CSS, replacing the previous Bootstrap-based layout. This update introduces a new documentation hub with a responsive sidebar and category-based navigation, a redesigned Credits page featuring a grid of contributor cards, and a new FAQ page with copy-to-clipboard link functionality. Additionally, new interactive tools have been added, including a 'Text and Font Compatibility Checker' that previews Unicode characters across multiple Quranic fonts, and an 'Enhanced Audio Comparison Tool' with waveform visualization and region selection capabilities.
app/views/community · high confidence
Redesigned resources page with advanced search and preview capabilities
The resources section has been overhauled to provide a richer browsing experience. A new hero banner introduces the library, while a robust search toolbar allows filtering by name, tags, and categories, with support for Quranic references (e.g., 2:255) to surface relevant content. Search results are intelligently grouped into 'Ayah-capable' and 'Related' sections, and an empty state message guides users when no matches are found. The interface now supports both list and grid views, and includes a dedicated preview component that renders Quranic scripts and fonts. Additionally, a new notice component clarifies the nature of external content, and a copyright page displays resource-specific licensing information.
app/views/resources · high confidence
Redesigned translation proofreading interface with multiple view modes
The translation proofreading tool now features a modernized UI using Tailwind CSS, replacing the previous Bootstrap-based layout. Users can now switch between four distinct viewing modes: 'Ayah view' (showing the verse and translation), 'Page view' (showing all translations on a page), 'Page with Arabic view' (displaying Arabic text alongside translations), and 'Proofreading view' (a split-screen layout with a PDF embed for reference). The edit form has been updated to use floating labels and includes client-side validation for translation and footnote text. Additionally, the main listing page now features a sticky table header for better navigation and uses a shared pagination component.
_app/views/translation\proofreadings · high confidence
Redesigns application layouts and email templates with Tailwind CSS and modern styling
The application's visual presentation has been updated across multiple layout templates. The main application layout now uses Tailwind CSS utilities, includes the Inter font, and features a new landing header and footer structure. Devise authentication pages have been restyled with a dedicated layout that includes a hero section and background animation. Email notifications have been completely redesigned with a branded, responsive wrapper, header image, and CTA button styling. Additionally, the PDF export layout has been updated to use Tailwind spacing classes, and a new grid partial has been introduced to standardize content width and alignment across pages.
app/views/layouts · high confidence
Redesigns the Quran Word Concordance tool with a unified header and modernized UI
The Word Concordance labeling interface has been visually and structurally updated to align with the new 'Quran corpus tool' design. The page now uses a shared header component that includes breadcrumbs and navigation actions (Previous/Next ayah or segment), replacing the previous standalone headers. The layout has been switched from Bootstrap to Tailwind CSS, featuring a centered container, sticky table headers for better data visibility, and updated styling for filters, buttons, and tables. Additionally, the view now renders a shared pagination partial and includes a 'Clear' button to reset filters, while internal links to admin resources have been updated to point to the CMS.
_app/views/word\_concordance\labels · high confidence
Refactor audio file generation jobs and remove Sidekiq dependency
The specific job responsible for generating surah audio files (GenerateSurahAudioFilesJob) and its subclass for updating verse durations (VerseAudioDurationJob) have been removed, replacing the previous implementation with a new generic AsyncResourceActionJob that delegates actions to resources. Additionally, the BackupJob and ExportMiniDumpJob have been updated to remove the Sidekiq::Status::Worker inclusion and associated cleanup logic, simplifying the background job infrastructure.
app/jobs · high confidence
Refactor text sanitization and improve import performance with batching
The text sanitization pipeline has been refactored: the previous \lib/text/base\_sanitizer.rb\ and \lib/text/base\_scrubber.rb\ classes have been removed in favor of \Utils::TextSanitizer::TafsirSanitizer\, which is now used by the importers for consistent text cleaning. Additionally, import performance has been improved by implementing batched inserts for draft translations in the QuranEnc importer, which now accumulates drafts and flushes them in groups of 500 rather than saving individually. The importer base class also now tracks and reports parse issues via \AdminTodo\ records through a new \run\_after\_import\_hooks\ mechanism.
lib/importer · high confidence
Refactor user registration flow and add custom session controller
The user registration process has been refactored to use Devise's built-in parameter sanitizer, which now explicitly permits the 'add\_to\_mailing\_list' field during sign-up, while the post-registration redirect has been changed to the new session path instead of the root path. Additionally, a new custom sessions controller has been introduced to handle return URL storage, ensuring that users are redirected to their intended destination after logging in.
app/controllers/users · high confidence
Rename String extension method from remove\_dialectic to remove\_diacritics
The \remove\_dialectic\ method in the \String\ initializer has been renamed to \remove\_diacritics\. This change updates the public API for stripping Arabic diacritical marks and hamza variants, ensuring the method name accurately reflects its function of removing diacritics rather than dialectic characters.
config/initializers/extensions · high confidence
Restructures admin notes area and tightens permissions
The admin interface for notes has been reorganized under a new 'Notes' menu parent, with configuration files moved into a dedicated subdirectory. Access to the Feedback resource is now restricted to index and show actions, removing the ability to destroy records. Important Note creation now associates notes with the current user instead of an admin user, and the redirect path has been updated to use the 'cms' namespace. Additionally, filters for verses and words now use the correct association names, and HTML rendering for note text is handled via a safe helper.
app/admin/notes · high confidence
Segments tool UI overhaul with timeline, comparison, and validation
The Segments tool has been redesigned with a modern Tailwind CSS interface, introducing a new Timeline component that visualizes word segments, supports zooming, and displays audio waveforms. Users can now compare segment timings from multiple sources side-by-side, validate segments for issues like overlaps or gaps, and toggle letter highlighting during playback. The update also includes a mobile warning, improved audio loading with file support, and replaces the previous toast notification system with a more robust configuration.
app/javascript/segments/components · high confidence
Standardized header alerts for tools with consistent styling and access requests
The header alerts for various tools (such as Ayah Dependency Graph, Tafsir, Translation, and Mushaf Layout) have been updated to use a consistent Tailwind CSS styling pattern and Stimulus-based dismissal. For tools requiring permission, the alerts now prominently feature a 'Request Access' button that opens a modal, replacing previous variations in layout and call-to-action placement to provide a uniform user experience across the tools section.
_app/views/tools/header\alert · high confidence
Standardized tools page layout with breadcrumbs and view toggles
The tools interface now uses a shared header partial that consistently displays breadcrumbs and a help button across all tool pages, replacing previous inconsistent header implementations. Additionally, the main tools listing page now features a unified layout with a search input and a toggle to switch between list and grid views for available resources, improving navigation and discoverability.
app/views/tools · high confidence
Support for .heading class in Active Admin sections
The styling for section headers in Active Admin has been updated to apply the same header styles to elements with the .heading class in addition to h3 tags. This allows for more flexible header styling within section components.
_app/assets/stylesheets/active\admin · high confidence
Surah audio segment builder UI overhaul and feature enhancements
The Surah audio files interface has been redesigned with Tailwind CSS, replacing the previous Bootstrap layout. The segment builder now supports undo/redo keyboard shortcuts, displays recitation text in the Digitalkhatt script, and allows comparing segments across different recitations. The index and show views now display the simple chapter name alongside the ID, use a sticky table header for better navigation, and render segment progress with a modern green progress bar. Additionally, the help modal has been updated to list the new keyboard shortcuts.
_app/views/surah\_audio\files · high confidence
Surah info pages migrated to Tailwind CSS and redesigned layout
The Surah info views (index, show, edit, changes, and diff components) have been completely restyled using Tailwind CSS, replacing the previous Bootstrap grid and utility classes. This migration introduces a new responsive layout with a standardized header component, updated form controls with focus states, and a redesigned table for the index view featuring sticky headers. Additionally, the 'Edit history' page has been removed, and the diff views now use a new \safe\_html\ helper for rendering content.
_app/views/surah\infos · high confidence
Toastr notification styles updated for consistency and visual depth
The toastr library styles have been refactored to use shared SCSS variables ($info, $danger, $success, $warning) instead of CSS custom properties (var(--bs-\*)), ensuring consistent color usage across the application. Additionally, the text shadow on toast titles has been enhanced from a simple white offset to a subtle black shadow (rgba(0, 0, 0, 0.25)), improving readability against various backgrounds.
app/assets/stylesheets/libs · high confidence
Unified draft content approval and import jobs
The system now uses a unified \DraftContent::ApproveDraftContentJob\ base class with specialized subclasses to approve and import draft translations, tafsir, word translations, and Uloom content. This replaces the previous \QuranEnc::ImportDraftTranslationJob\ (renamed to \DraftContent::ImportDraftContentJob\), which now supports importing from both QuranEnc and TafsirApp sources. The new jobs handle bulk imports with batching, manage footnotes for translations, archive old tafsir records, and automatically mark drafts as imported. A new \CheckContentChangesJob\ monitors QuranEnc for updates and triggers auto-imports, while a \RemoveDraftContentJob\ provides a way to clean up draft content and associated todos.
_app/jobs/draft\content · high confidence
Welcome email rebranded to Quranic Universal Library (QUL)
The 'thank\_you' mailer template has been completely rewritten to reflect the new Quranic Universal Library (QUL) brand. Users now receive a concise welcome message that introduces QUL as an open platform for Muslim developers, scholars, and researchers. The email replaces the previous generic Quran.com community invitation with specific calls to action: downloading Quranic resources, exploring developer tools, contributing to the open-source GitHub repository, and joining the Discord community. The old structure, which included a logo, a Discord join button, and general team background, has been removed in favor of a streamlined, product-focused onboarding experience.
_app/views/user\mailer · high confidence
Fixes
1 commit (1 fix) fixing app/views/ayah\_themes
A fix in app/views/ayah\_themes — 1 commit (1 fix), 4 files: “Add a tool to suggest fixes for ayah themes (\#980)” (refs \#980).
_app/views/ayah\themes · medium confidence · unverified
1 commit (1 fix) fixing app/views/contributions\_mailer
A fix in app/views/contributions\_mailer — 1 commit (1 fix), 2 files: “Let any signed-in user suggest fixes in the proofreading tools (\#949)” (refs \#949).
_app/views/contributions\mailer · medium confidence · unverified
1 commit (1 fix) fixing app/views/similar\_ayahs
A fix in app/views/similar\_ayahs — 1 commit (1 fix), 6 files: “Add a tool to suggest fixes for similar ayahs (\#987)” (refs \#987).
_app/views/similar\ayahs · medium confidence · unverified
1 commit (1 fix) fixing app/views/topics
A fix in app/views/topics — 1 commit (1 fix), 4 files: “Add a tool to suggest fixes for ayah topics (\#979)” (refs \#979).
app/views/topics · medium confidence · unverified
2 commits (2 fixes) fixing app/views/lemmas
A fix in app/views/lemmas — 2 commits (2 fixs), 8 files: “Add a tool to suggest fixes for word lemmas (\#983)”; “Add a tool to suggest fixes for the root, stem and lemma of words (\#984)” (refs \#983, \#984).
app/views/lemmas · medium confidence · unverified
2 commits (2 fixes) fixing app/views/roots
A fix in app/views/roots — 2 commits (2 fixs), 4 files: “Add a tool to suggest fixes for the root, stem and lemma of words (\#984)”; “Add a tool to suggest fixes for word roots (\#981)” (refs \#984, \#981).
app/views/roots · medium confidence · unverified
2 commits (2 fixes) fixing app/views/stems
A fix in app/views/stems — 2 commits (2 fixs), 4 files: “Add a tool to suggest fixes for word stems (\#982)”; “Add a tool to suggest fixes for the root, stem and lemma of words (\#984)” (refs \#982, \#984).
app/views/stems · medium confidence · unverified
9 commits (9 fixes) fixing app/jobs/recurring
A fix in app/jobs/recurring — 9 commits (9 fixs), 1 file: “Add a tool to suggest fixes for word stems (\#982)”; “Add a tool to suggest fixes for word lemmas (\#983)”; “Let any signed-in user suggest fixes in the proofreading tools (\#949)”; and 6 more (refs \#982, \#983, \#949, \#979, \#984, …).
app/jobs/recurring · medium confidence · unverified
Fix 500 errors from invalid page parameters
Added a controller concern that sanitizes the 'page' query parameter to prevent 500 errors caused by crawlers or scanners sending junk data (such as URLs or null bytes). Invalid or non-positive page values are now treated as page 1, ensuring paginated actions remain stable.
app/controllers/concerns · high confidence
Improved audio segment finding reliability and new playback helpers
The segment helper logic now prevents crashes when verse data is missing or timestamps are out of range by adding null checks and replacing recursive verse-finding with a bounded iterative loop. Segment lookup within a verse has been optimized from linear to binary search. Additionally, new helper modules were added to manage audio playback (handling user-interaction constraints) and to read/write start/end time parameters in the URL for range-based playback.
app/javascript/segments/helper · high confidence
Test coverage
1 commit adding/updating tests in test/models; Added Cypress end-to-end tests for user authentication flows; Added tests for NoorBayan morphology parsing and Treebank rendering; Added tests for Quran reference parsing and resource search queries; Added tests for Quran search normalization, highlighting, and query parsing; Added tests for Russian morphology locale parity; Added tests for audio segment validation and auto-fixing; Added tests for morphology types, POS tag locale consistency, and recitation segment tag splitting.
Dependencies
Upgrade to Rails 8 and Ruby 3.3 with comprehensive dependency updates
The application has been upgraded from Rails 7.0 to Rails 8.0 (specifically 8.0.5.1) and the Ruby runtime requirement has been raised to version 3.3.3–3.3.10. This major platform upgrade is accompanied by significant updates to core gems, including Nokogiri (to 1.19.4), Devise (to 5.0.4), Sidekiq (to 7.2.4), and Active Admin (to 3.2.3). Front-end dependencies have also been updated, notably upgrading the Trix editor to version 2.1.19 and esbuild to 0.25.12, while adding new libraries such as Tailwind CSS, Chartkick, and FFI-Hunspell to support modern styling and text processing features.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 35 → 33 (-2.3)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 27 → 28 (+0.2)
- Architecture 87 → 87 (-0.3)
- Maturity 58 → 63 (+4.8)
- Readiness 36 → 27 (-9.2)
- Security 41 → 41 (-0.1)
- Domain Modelling 66 → 54 (-11.9)
- Accessibility 35 → 36 (+0.6)
- Performance 89 → 89 (+0.0)
Resolved (71)
- Boundary-crossing change coupling: ability.rb ↔ routes.rb (app/models/ability.rb)
- Critical IaC: DS-0031 (Dockerfile)
- Critical IaC: DS-0031 (Dockerfile)
- Critical IaC: DS-0031 (Dockerfile)
- Critical IaC: DS-0031 (Dockerfile)
- Documentation: no installation or build instructions (README.md)
- Documentation: no usage examples (README.md)
- Duplicated block (22 lines × 4) (app/helpers/tool_docs_helper.rb)
- Duplicated block (22–24 lines × 4) (app/helpers/tool_docs_helper.rb)
- Duplicated block (23–24 lines × 3) (app/helpers/tool_docs_helper.rb)
- Duplicated block (25 lines × 3) (app/helpers/tool_docs_helper.rb)
- Duplicated block (27 lines × 2) (app/helpers/tool_docs_helper.rb)
- Duplicated block (57 lines × 2) (app/presenters/tafsir_presenter.rb)
- Duplicated block (9 lines × 2) (lib/similar_ayah_phrase_search.rb)
- FileTooLong: public/compare-font.html (public/compare-font.html)
- High CVE: [GHSA redacted] (bun.lock)
- High CVE: [GHSA redacted] (bun.lock)
- High CVE: [GHSA redacted] (bun.lock)
- High CVE: [GHSA redacted] (bun.lock)
- High vulnerability: [GHSA redacted] (bun.lock)
- …and 51 more
New (109)
- Aligner.mark_moved (cognitive 17) (app/services/mutashabihat/aligner.rb)
- Boundary-crossing change coupling: tajweed_words_controller.rb ↔ tajweed_word.rb (app/controllers/tajweed_words_controller.rb)
- Change coupling: tajweed_words_controller.rb ↔ tajweed_rules.rb (app/controllers/tajweed_words_controller.rb)
- Change coupling: tool_docs_helper.rb ↔ tools_helper.rb (app/helpers/tool_docs_helper.rb)
- Change coupling: word.rb ↔ tajweed_rules.rb (app/models/word.rb)
- Critical CVE: [CVE redacted] (bun.lock)
- Critical CVE: [GHSA redacted] (yarn.lock)
- Critical IaC: DS-0031 (Dockerfile)
- Critical IaC: DS-0031 (Dockerfile)
- Critical IaC: DS-0031 (Dockerfile)
- Critical IaC: DS-0031 (Dockerfile)
- Duplicated block (10–11 lines × 2) (app/models/draft/tafsir.rb)
- Duplicated block (13 lines × 2) (app/helpers/tool_docs_helper.rb)
- Duplicated block (13 lines × 2) (app/helpers/tool_docs_helper.rb)
- Duplicated block (13 lines × 3) (app/admin/draft/lemma.rb)
- Duplicated block (13–14 lines × 3) (app/helpers/tool_docs_helper.rb)
- Duplicated block (14 lines × 2) (app/admin/draft/lemma.rb)
- Duplicated block (15 lines × 7) (app/admin/draft/ayah_theme.rb)
- Duplicated block (16 lines × 2) (app/helpers/tool_docs_helper.rb)
- Duplicated block (18 lines × 2) (app/admin/word_translation.rb)
- …and 89 more
Changes since last survey
- 49 commits — 35 feature/other, 14 fixes
By area
- app/views — 28 commits
- app/helpers — 5 commits
- app/models — 5 commits
- app/javascript — 2 commits
- config/routes.rb — 2 commits
- lib/exporter — 2 commits
- (root) — 1 commit
- .github/ISSUE_TEMPLATE — 1 commit
- .github/workflows — 1 commit
- app/assets — 1 commit
- app/controllers — 1 commit
Notable commits
- fix: Add a tool to suggest fixes for ayah themes (#980)
- fix: Add a tool to suggest fixes for ayah topics (#979)
- fix: Add a tool to suggest fixes for similar ayahs (#987)
- fix: Add a tool to suggest fixes for the root, stem and lemma of words (#984)
- fix: Add a tool to suggest fixes for word lemmas (#983)
- fix: Add a tool to suggest fixes for word roots (#981)
- fix: Add a tool to suggest fixes for word stems (#982)
- fix: Call the proofreading edit buttons "Suggest a fix" and add a typo-only checkbox (#972)
- fix: Fix saving tajweed rules, improve the palette and help (#927)
- fix: Let any signed-in user suggest fixes in the proofreading tools (#949)
- fix: Let any signed-in user suggest surah info fixes (#997)
- fix: Show fixes waiting for review on the tool pages (#974)
- fix: [TA-6702] fix: replace previous rows when re-exporting SQLite (#998)
- fix: fix db config for db backup (#1011)
- change: Add "How to use this resource" to the quran-metadata Help tabs (#893)
- change: Add Preview, Docs and Licence tabs to resource pages (#943)
- change: Add a tool to cut ayah audio from gapless surah audio (#966)
- change: Add reusable licences to resource pages (#946)
- change: Compare audio help and tool layout (#930)
- change: Drop no-op replace in font preview glyph search (#890)
- …and 29 more
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
TarteelAI/quranic-universal-library was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 3d805f64174c7580b2804714616ed2a2a80e8b8a — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-60d1b390edf0.