# SPA To-Do List
*Last Updated: 2025-11-22*
---
## 🎯 Website Features & Enhancements
### ✅ Completed
- [x] Create image-descriptions.json structure
- [x] Extract 429 image descriptions from artwork gallery pages
- [x] Populate JSON with BBT Media descriptions
- [x] Rename JSON to .json.md for Obsidian Publish compatibility
- [x] Modify publish.js to load image descriptions
- [x] Add caption display to lightbox
- [x] Style captions with gradient overlay and blur effect
- [x] Create loading screen HTML/CSS
- [x] Add ISKCON logo with fade-in animation
- [x] Update site name to "Prabhupada.io"
- [x] Add floating and breathing animation to logo
- [x] Implement smooth fade-out on page load
- [x] Implement sidebar random Prabhupada photos (80 images)
- [x] Fix image file naming issues (1,372 files renamed)
- [x] Add sidebar image CSS styling with hover effects
- [x] Fix domain URL issues for Obsidian Publish
### 🔄 In Progress
- [ ] Review and verify all 429 image descriptions for accuracy
- [ ] Test lightbox captions on all image types
- [ ] Verify caption styling on mobile devices
### 📋 Upcoming
- [ ] Add dates/locations to image metadata where available
- [ ] Add source attribution to artwork descriptions
- [ ] Add keyboard navigation info to captions (arrow keys, ESC)
- [ ] Consider adding image counter (e.g., "3 of 15")
- [ ] Optimize 11MB index file loading
- [ ] Implement progressive loading for large pages
- [ ] Add service worker for offline functionality
- [ ] Compress and optimize sidebar images
- [ ] Lazy load images in artwork galleries
- [ ] Add zoom functionality to lightbox
- [ ] Support for image galleries with multiple images
- [ ] Add fullscreen mode for images
- [ ] Implement image preloading for faster navigation
- [ ] Add download option for high-res images
---
## 📚 Index Projects
### Bhagavad-gītā Index ✅ COMPLETE
**Completed:** 2025-11-13
**Status:** ✅ Production Ready
**Success Rate:** 99.6% (7,779 of 7,811 references mapped)
**Output:** `BG_UNIFIED_INDEX_FINAL.json` (3.8 MB)
#### Completed Phases
- [x] Phase 1: Page-to-Verse Mapping - `extract_bg_pages_exact.py`
- [x] Phase 2: Complete Mapping - `create_bg_complete_mapping.py`
- [x] Phase 3: Index Extraction - Vision API extraction (17 batches)
- [x] Phase 4: URL Enrichment - `convert_bg_pages_final.py`
- [x] Phase 5: Unified Index - `merge_bg_indexes_final.py`
### Śrī Caitanya-caritāmṛta Index ✅ COMPLETE
**Completed:** 2025-11-12
**Status:** ✅ Production Ready
**Coverage:** 17 volumes (Ādi, Madhya, Antya)
**Results:** 1,603 unique terms, 6,722 page references
**Output:** `CC_UNIFIED_INDEX.json` (3.29 MB)
#### Completed Phases
- [x] Phase 1: Manifest Creation - 33 batches identified
- [x] Phase 2: Vision-Based Extraction - 100% diacritic preservation
- [x] Phase 2b: Format Standardization - 29 batches
- [x] Phase 3: Page-to-Verse URL Conversion - 6,507 references mapped
- [x] Phase 4: Unified Index Creation
### Śrīmad-Bhāgavatam Index
#### Prerequisites
- [ ] Obtain 30 page-numbered SB PDFs (single-page scans)
- [ ] Verify PDF page numbers match printed page numbers
- [ ] Extract SB index pages (if not already available)
- [ ] Organize files in proper directory structure
#### Phase 1: Page-to-Verse Mapping
- [ ] Adapt `extract_bg_pages_exact.py` → `extract_sb_pages_exact.py`
- [ ] Run extraction on all 30 volumes
- [ ] Verify output: `SB_PAGE_TO_VERSE_EXACT.json`
- [ ] Spot check 20-30 random pages for accuracy
#### Phase 2: Complete Mapping
- [ ] Adapt `create_bg_complete_mapping.py` → `create_sb_complete_mapping.py`
- [ ] Fill continuation pages for all volumes
- [ ] Verify output: `SB_PAGE_TO_VERSE_COMPLETE.json`
- [ ] Confirm 100% coverage
#### Phase 3: Index Extraction
- [ ] Extract SB index pages from volumes
- [ ] Run Vision API extraction (similar to CC workflow)
- [ ] Verify Sanskrit diacritics preserved
- [ ] Save batches: `sb_indexes/sb_v{XX}_batch{YY}.json`
#### Phase 4: URL Enrichment
- [ ] Adapt `convert_bg_pages_final.py` → `convert_sb_pages_final.py`
- [ ] Enrich all SB index batches with verse URLs
- [ ] Verify output: `sb_indexes_enriched_final/`
- [ ] Check success rate (target: >99%)
#### Phase 5: Unified Index
- [ ] Adapt `merge_bg_indexes_final.py` → `merge_sb_indexes_final.py`
- [ ] Merge all 30 volume indexes
- [ ] Verify output: `SB_UNIFIED_INDEX_FINAL.json`
- [ ] Calculate final statistics
#### Documentation
- [ ] Create `SB_INDEX_FINAL_SUMMARY.md`
- [ ] Document any challenges/solutions
- [ ] Update methodology for future projects
### General Indexing Tasks
#### ✅ Completed
- [x] Six Gosvāmīs corrected - All 6 members with proper descriptions
- [x] Daśāvatāra completed - All 10 incarnations properly ordered
- [x] Vedic deities organized - 33 gods (12 Ādityas, 11 Rudras, 8 Vasus, 2 Aśvins)
- [x] Puranic deities distinguished - Trimūrti, Tridevī, and post-Vedic forms
- [x] Varṇāśrama expanded - Complete 4×4 matrix with all varṇas and āśramas
- [x] Index reorganization - 11,814 entries into thematic categories (2025-11-08)
- [x] Personality index cleanup - Removed 1,147 fabricated links, verified 45 valid links
- [x] Created 35 category files (16 personalities, 7 places, 6 concepts, 6 scriptures)
#### 🔄 In Progress
- [ ] Converting index entries into full articles
- [ ] Adding contextual descriptions to terms
- [ ] Building semantic relationship maps
- [ ] Creating study guides from index data
- [ ] Developing search optimization
#### 📋 Upcoming
- [ ] Multi-language term mapping
- [ ] Historical timeline integration
- [ ] Geographical mapping system
- [ ] Concept hierarchy trees
- [ ] Automated excerpt generation
- [ ] Complete personality index refinement
- [ ] Generate concept overview articles
- [ ] Create study guide templates
- [ ] Develop daily reading programs
- [ ] Build search optimization
### Index Taxonomy Research
- [ ] Review traditional indices in BBT books (if available)
- [ ] Check VedaBase organization structure
- [ ] Consult with Vaishnava scholars if possible
- [ ] Choose structure: Option A, B, or C
- [ ] Map existing entries to new categories
- [ ] Design cross-reference system
- [ ] Create new category files
- [ ] Migrate/cross-reference entries
- [ ] Update index.md with philosophical explanation
- [ ] Add "How to Use" guide explaining both Western and traditional approaches
---
## 🎙️ Spoken Transcripts Migration
### Phase 1: Assessment
- [ ] Locate the converted VedaBase HTML/Markdown files from 2025 conversion
- [ ] Analyze current file format and structure
- [ ] Identify what metadata is available
- [ ] Count how many files need processing
- [ ] Compare with existing spoken files to identify gaps
### Phase 2: Script Development
- [ ] Create extraction script to parse VedaBase format
- [ ] Handle speaker attributions consistently
- [ ] Preserve Sanskrit/Devanagari text
- [ ] Format verse references
- [ ] Clean up encoding issues
- [ ] Handle special cases (partial recordings, multiple speakers, etc.)
### Phase 3: Batch Processing
- [ ] Process files year by year
- [ ] Create folder structure
- [ ] Write formatted Markdown files
- [ ] Verify file count matches expected
- [ ] Check for duplicates with existing files
### Phase 4: Integration
- [ ] Update folder notes with new files (if needed)
- [ ] Verify wiki links work correctly
- [ ] Update today section with new content
- [ ] Generate statistics
### Phase 5: Quality Assurance
- [ ] Spot-check random samples from each year
- [ ] Verify metadata accuracy
- [ ] Check frontmatter consistency
- [ ] Ensure proper Unicode/diacritics
- [ ] Validate file naming conventions
---
## 🎨 Content & Artwork
### Artwork Gallery
- [ ] Complete all artwork gallery categorization
- [ ] Add more personality galleries
- [ ] Expand thematic galleries
- [ ] Create cross-references between related images
- [ ] Add verse references to artwork where applicable
- [ ] Add artist information to image metadata
- [ ] Link artwork to corresponding book passages
- [ ] Create curated collections/tours
- [ ] Add image annotations for complex scenes
### Image Management
- [ ] Add alt text to all images
- [ ] Add image comparison slider for different editions
- [ ] Create timeline view for artwork by publication date
- [ ] Add "related images" suggestions
- [ ] Implement favorites/bookmarking system
- [ ] Add sharing functionality for images
- [ ] Create printable versions of artwork
- [ ] Add image collections for educators
- [ ] Create mobile app for offline access
---
## 🛠️ Technical & Infrastructure
### Project Organization ✅ COMPLETE
**Completed:** 2025-11-11
#### Completed Tasks
- [x] Created new directory structure (data/, docs/reports/, docs/guides/, temp/, backups/)
- [x] Moved all files to appropriate directories
- [x] Updated .gitignore configuration
- [x] Consolidated backup folders
### Performance Optimization
- [ ] Review and optimize publish.js performance
- [ ] Minify CSS and JavaScript for production
- [ ] Remove unused CSS rules
- [ ] Consolidate duplicate code
- [ ] Add error handling for edge cases
### Browser Compatibility
- [ ] Test loading screen on Safari
- [ ] Test lightbox captions on Firefox
- [ ] Verify animations on mobile browsers
- [ ] Test on older browsers (fallbacks)
### Accessibility
- [ ] Improve keyboard navigation throughout site
- [ ] Add ARIA labels to interactive elements
- [ ] Test with screen readers
- [ ] Ensure sufficient color contrast
- [ ] Add smooth scroll behavior
- [ ] Improve mobile navigation
- [ ] Add breadcrumb navigation
- [ ] Enhance search functionality
- [ ] Add keyboard shortcuts documentation
### SEO & Meta
- [ ] Verify all meta tags are properly set
- [ ] Add Open Graph images for social sharing
- [ ] Optimize page titles and descriptions
- [ ] Add structured data for artwork
---
## 📝 Documentation
### User Documentation
- [ ] Document image description JSON format
- [ ] Create style guide for image captions
- [ ] Add developer documentation for publish.js
- [ ] Document loading screen customization options
### Technical Documentation
- [ ] Update README with recent changes
- [ ] Document new features and enhancements
- [ ] Create migration guides for major updates
- [ ] Add troubleshooting guides
---
## 📊 Data & Content Quality
### Content Verification
- [ ] Verify all image descriptions are accurate
- [ ] Check all internal links are working
- [ ] Validate all verse references
- [ ] Ensure consistent formatting across files
### Data Management
- [ ] Review and update metadata schemas
- [ ] Standardize front-matter across all files
- [ ] Clean up duplicate entries
- [ ] Verify Unicode/diacriticals consistency
---
## 🌟 Feature Ideas & Future Enhancements
### Interactive Features
- [ ] Add comments/discussion on images
- [ ] Allow user contributions for missing metadata
- [ ] Create virtual study rooms
- [ ] Add progress tracking for reading plans
- [ ] Implement annotation system for personal notes
### Community Features
- [ ] Build discussion forums integration
- [ ] Create user profiles and preferences
- [ ] Add social sharing features
- [ ] Implement collaborative study groups
- [ ] Create educator resources portal
### Advanced Features
- [ ] Add AI-powered semantic search
- [ ] Implement voice navigation
- [ ] Create interactive timelines
- [ ] Build relationship graphs between concepts
- [ ] Add multilingual support
---
## 📌 Priority Legend
- 🔴 **High Priority** - Critical for site functionality
- 🟡 **Medium Priority** - Important improvements
- 🟢 **Low Priority** - Nice-to-have enhancements
- 💡 **Future Ideas** - Long-term considerations
---
## 📅 Current Sprint Focus
1. Website performance optimization (11MB index loading)
2. Complete SB index project (Phase 1-2)
3. Image gallery enhancements and verification
4. Mobile UX improvements
5. Accessibility improvements
---
*For detailed technical specifications, see `/docs` folder*
*For project history and completed work, see `/docs/reports`*