Init Devlog

phew! after hassling and trying to add cloud convert functionality, i felt that the old transcription result component was super ugly, so i refactored it with some design help from claude

Hereby I present to you:

🎉 Transcriptr v2.1.0 Update - Enhanced Download System!

Hey everyone! We're excited to announce Transcriptr v2.1.0 with some fantastic new features that make working with your transcriptions even better! 📄✨

🆕 What's New

📥 Multi-Format Download System

Your transcriptions are now available in 4 different formats:
- 📝 TXT - Plain text for simple sharing
- 📋 Markdown - Structured format with headings

- 📄 DOCX - Professional Word documents
- 🔴 PDF - Print-ready documents with proper formatting

All accessible from a sleek dropdown menu with beautiful icons! 🎨

🌍 Smart Arabic Language Support

• Automatic detection of Arabic text in your transcriptions
• Clear beta warnings for DOCX and PDF formats when using Arabic
• Helpful recommendations to use TXT or Markdown for best Arabic compatibility
• User-friendly notices explaining format limitations

🎨 Beautiful UI Improvements

• Unified card design - Clean, mobile-inspired layout
• Enhanced dropdown visibility - Solid backgrounds with proper contrast
• Professional document generation - Real DOCX files with proper structure
• Optimized performance - Better memory management and faster downloads

🔧 Technical Enhancements

📄 Real Document Generation

• DOCX files now use the proper docx library for authentic Word documents
• PDF files feature automatic text wrapping and professional layout
• Markdown exports include structured headings and formatting

🌐 Internationalization

• Unicode detection for Arabic text using comprehensive character ranges
• Format-specific warnings that appear only when relevant
• Smart recommendations based on language detection

🚀 Continued Universal Audio Support

Don't forget about our existing 15+ audio format support:
- iPhone recordings (M4A) ✅
- Windows media (WMA) ✅

- Professional formats (AIFF, CAF) ✅
- All major formats with automatic conversion ✅

💡 What This Means for You

1. More flexibility - Choose the perfect format for your needs
2. Better workflow integration - DOCX files work perfectly with Word, Google Docs
3. Print-ready documents - PDFs look professional and format consistently
   
4. Arabic language support - Clear guidance for non-Latin script users
5. Cleaner interface - Everything organized and easy to find

🎯 Perfect For:

• Students sharing notes in different formats
• Professionals creating formal documents
  
• Content creators working with transcripts
• International users working with Arabic content
• Anyone who wants flexibility in their workflow

Try it out now at transcriptr.aramb.dev and let us know what you think!

Tue, 22 Jul 2025

v2.1.0

New
🎵 Universal Audio Format Support: Added automatic audio format conversion powered by CloudConvert API

🔄 Seamless Format Conversion: M4A, AAC, MP4, WMA, AIFF, and CAF files are now automatically converted to MP3 before transcription

📱 iPhone Recording Support: Native support for M4A files from iPhone Voice Memos and other iOS recording apps

🎧 Windows Media Audio Support: Added WMA file support for Windows users

🍎 macOS Audio Support: Full compatibility with AIFF and CAF audio formats from macOS applications

⚡ CloudConvert API Integration: New /api/convert/cloud endpoint with comprehensive job management and error handling

🔍 Intelligent Format Detection: Advanced file format detection utility with 15+ supported audio formats

👁️ Real-Time Conversion Transparency: Added detailed API response logging visible in UI details panel during conversion

📊 Conversion Progress Tracking: Live status updates with step-by-step conversion process visibility

🔒 Secure Temporary File Handling: Automatic cleanup of conversion files with privacy-focused temporary storage

📋 Enhanced File History: Converted files now properly appear as 'file uploads' in transcription history with original filenames

🎯 Smart Conversion Routing: Automatic detection and routing based on file format without user intervention

⚙️ CloudConvert Health Monitoring: Built-in API health checks and service availability validation

📖 Comprehensive Format Documentation: Updated documentation with detailed format support matrix and conversion explanations

Improved
🚀 Enhanced User Experience: Conversion process is completely transparent with immediate 'Converting...' UI feedback

⏱️ Processing Time Optimization: Direct formats (MP3, WAV, FLAC, OGG) process immediately, converted formats add only 30-60 seconds

🔄 Automatic Workflow Integration: Conversion seamlessly flows into existing transcription pipeline without user interaction

📱 Mobile Conversion Support: All conversion features fully functional on mobile devices with touch-optimized interfaces

🎨 Visual Format Indicators: Color-coded format categories (green for direct support, blue for auto-conversion) in documentation

📊 Enhanced Progress Visualization: Updated TranscriptionProcessing component with conversion-specific status messages

🔧 Improved Error Handling: Better error messages and fallback options for conversion failures

📝 Updated Help Documentation: Completely rewritten audio format support section with visual guides and process explanations

🏷️ File Format Classification: Clear distinction between 'directly supported' and 'auto-converted' formats for user expectations

🔍 Enhanced File Validation: Improved file type detection with both extension and MIME type checking

📚 README Documentation: Updated project README with comprehensive CloudConvert setup instructions and format support matrix

⚡ Environment Configuration: Enhanced environment variable documentation for CloudConvert API setup

Fixed
🔄 Session History Persistence: Fixed transcription history only keeping most recent entry - now properly accumulates all transcriptions chronologically

🆔 Session ID Management: Modified createSession() to always generate unique session IDs instead of reusing cookie values

📱 SSL Certificate Issues: Resolved development environment SSL certificate errors in Replicate API calls

🎯 UI State Management: Fixed conversion status not appearing immediately - UI now shows 'Converting...' state instantly

📋 File History Categorization: Resolved converted files appearing as 'URL audio' - now properly categorized as file uploads with original filenames

🔄 Conversion Flow Metadata: Enhanced data flow to preserve original file information throughout conversion process

💻 File Input Validation: Updated file input to accept all supported formats including M4A, AAC, and other convertible types

⚠️ UnsupportedFormatHelp Component: Updated component to handle conversion failures rather than format rejection

V2 is here!

Welcome to the completely redesigned Transcriptr! We've rebuilt the entire platform from the ground up to deliver a faster, more reliable, and feature-rich transcription experience.

Lightning Fast Performance
Completely rewritten with Next.js for blazing-fast load times and seamless user experience.

Enhanced Reliability
Improved error handling, better file format support, and automatic retry mechanisms for failed transcriptions.

Modern Interface
Beautiful new design with improved accessibility, better mobile support, and intuitive user workflows.

Ready to experience the future of transcription? Upload your first file and see the difference!

feat: implement global text size adjustment across entire application

• Add fontSize from SettingsContext to all text components throughout the app
• Update ThemedText component to use dynamic font sizing with multipliers
• Replace hardcoded fontSize values in StyleSheets with dynamic scaling:
  • Titles: fontSize * 1.75-2
  • Subtitles: fontSize * 1.25
    
  • Regular text: fontSize
  • Small text: fontSize * 0.81-0.94
• Apply text size adjustment to main screens:
  • Lessons list (app/(tabs)/index.tsx)
  • Vocabulary screen (app/(tabs)/vocabulary.tsx)
  • Individual lesson screens (app/lessons/[bookId].tsx, app/lessons/[bookId]/[lessonId].tsx)
  • Vocabulary detail screen (app/vocabulary/[id].tsx)
  • ComingSoon and EditScreenInfo components
• Ensure consistent font scaling across all UI components and content areas
• Fix accessibility issue where text size setting only affected settings menu

Closes: Text size adjustment now works universally throughout the entire application interface

feat(settings): overhaul settings screen with native-style UI

This commit completely redesigns the main settings screen to provide a more modern, intuitive, and platform-consistent user experience, moving away from a basic SectionList to a custom-styled ScrollView with grouped cards.

• Replaces SectionList with a ScrollView and styled cards for a native look and feel.
• Reorganizes settings items into more logical groups: Content & Learning and Support & Info.
• Adds a new Rate This App screen to encourage user feedback and store ratings.
• Refactors all settings sub-screens (Appearance, About, etc.) to use the unified useSettings context and adopt consistent, theme-aware styling.
• Bumps app version to 0.0.8 to reflect the new features and UI enhancements.

had some errors, trying to figure out theming

Working on android version now, fixed icons using material UI icons

I have been working on adding the vocabulary page, and synchronizing it with the API which I was working on prior to this.

There are multiple changes here:

Added list of vocabs fetching from API
Added a filter
updated edge cases for filters, added clear filter button
used SF Symbols (for iPhone only) for the filter icon, and made it a nice modal

Finally finished with vocab API, about to integrate with app

Having lots of problems with nextjs pageprops :(

This pull request introduces several configuration updates and documentation changes to enhance development workflows and enforce coding standards. The most important changes include adding accessibility and coding rules, updating editor settings for consistent formatting, and preserving TypeScript errors in lesson content for educational purposes.

Accessibility and Coding Rules

• .github/copilot-instructions.md: Added extensive rules for accessibility and coding practices, covering ARIA attributes, semantic elements, JavaScript best practices, and TypeScript conventions. These rules aim to improve code quality and maintainability.

Editor Configuration Updates

• .vscode/settings.json: Configured default formatters for multiple file types, enabled format-on-save and format-on-paste, and set up code actions for fixing issues and organizing imports using Biome and Prettier.
• .gemini/settings.json: Set the preferred editor to zed for a streamlined editing experience.

Educational Content Rules

• .kilocode/rules/rules.md: Added rules to preserve TypeScript errors in lesson content, emphasizing their educational value in teaching vocabulary and grammar concepts.

fix(data): align all book 1 lesson data with the authoritative schema

This commit resolves widespread schema inconsistencies found across all lesson files in src/data/vocab/book1/lessons/. The data structures in these files did not match the authoritative TypeScript interfaces defined in src/data/vocab/vocab.ts, leading to potential type errors and data integrity issues.

The following systematic corrections have been applied to all 23 lesson files:

• Title and Description Keys: The title and description objects in each lesson file were updated to use the standardized ar and en keys, replacing the non-compliant arabic and english keys.

• Translation Keys: The translation object within each vocabulary item was updated to use the en key, replacing the non-compliant english key.

• Example Keys: The objects within the examples array for each vocabulary item were updated to use arabic and english keys, replacing the non-compliant ar and en keys.

These changes ensure that all lesson data is now type-safe and strictly conforms to the defined schema, improving maintainability and preventing future validation errors.

feat(vocab): enrich vocabulary data with examples and detailed properties

This commit introduces a comprehensive update to the vocabulary data for Book 1, significantly enhancing the learning experience.

Key changes include:
- Example Sentences: Added multiple usage examples with translations for nearly every vocabulary item across all lessons (1-23).
- Data Enrichment: Populated transliteration, provided more detailed definition fields, and added/refined tags for better categorization.
- Data Structure Refactoring: Standardized language keys from ar/en to arabic/english in title, translation, and examples objects for consistency.
- Corrections & Diacritics: Added missing diacritical marks to Arabic words and corrected various vocabulary items and their plural forms.

adding examples to all of the lesson in book1

changing the layout

refactor(vocab): simplify lesson vocabulary data structure

Each lesson vocabulary file now exports a single lesson object directly, rather than an array containing a single object. This simplifies the data structure and makes it easier to import and consume individual lesson vocabularies.

BREAKING CHANGE: The vocabularyLists export has been removed from lesson vocabulary files.

due to the sheer complexity and length of these vocab lists, i will be seperating them by lesson in the data/vocab directory

finished up to lesson 7

adding vocab 3, skipped over 2, will come back later

done with v1

Finally finished vocab for madinah book 1

Using Gemini 2.5 Pro to extract lesson data from those 3 PDFs

I am about to develop and add support for madinah book vocab
Book 1 vocab:
https://www.salafipublications.com/sps/downloads/pdf/SCL090002.pdf
book2 vocab:
https://fathiquote.wordpress.com/wp-content/uploads/2019/01/vocabulary-madinah-book02.pdf
book 3 vocab:
https://drive.usercontent.google.com/download?id=15fKIyt_w9AsZ5sZL4n1RliGLCerZAGQW&export=download&authuser=0

https://github.com/aramb-dev/madinah/blob/nextjs/vocabulary-schema-design.md

Made many changes to visual appearance of the app

check github for log: https://github.com/aramb-dev/madinah-app

adding liquid glass for apple devices

using https://callstackincubator.github.io/react-native-bottom-tabs/docs/guides/usage-with-expo-router.html

added API
https://madinah.arabic.aramb.dev/docs
https://madinah.arabic.aramb.dev/api