A comprehensive digital library of Wardley Mapping resources, strategic analysis reports, and business strategy books. Built with Vercel serverless functions and modern web technologies for optimal performance and user experience.
🌐 Live Application: https://library.wardleymaps.ai/
- 📚 182+ Books: Comprehensive collection of strategic analysis and Wardley Mapping resources
- 🔍 Smart Search: Real-time search with category filtering and fuzzy matching
- 📖 Interactive Reading: Table of contents navigation, responsive design, mobile-optimized
- 📊 Readability Analysis: Complete text analysis with 6 industry-standard metrics (Flesch, Flesch-Kincaid, Fog, SMOG, ARI, Coleman-Liau)
- 🎯 Auto-Categorization: AI-powered book categorization across multiple domains
- 🔗 Smart Linking: Deep linking to book sections, Wardley map reports, share functionality
- ⚡ High Performance: Serverless architecture with optimized loading and caching
Visit library.wardleymaps.ai to browse and read books instantly.
# Clone the repository
git clone https://github.com/tractorjuice/GenAI-Books.git
cd GenAI-Books
# Install dependencies
npm install
# Generate book manifest
npm run generate-manifest
# Start local development
npm run test-server├── api/ # Vercel serverless functions
│ ├── books.js # Books listing API
│ ├── books/[id].js # Individual book details
│ └── wardley/ # Wardley map integration
├── books/ # Book content library (182+ books)
├── docs/ # Comprehensive documentation
├── public/ # Frontend application
├── scripts/ # Utility scripts
└── tests/ # Test suite
The library covers diverse strategic domains:
- Strategic Mapping (53 books): Wardley Mapping methodology and applications
- Artificial Intelligence (89 books): GenAI, LLMs, and AI strategy
- Business Strategy (30 books): Strategic planning and competitive advantage
- Government (10 books): Public sector transformation and policy
- Sustainability (15 books): Environmental and social governance
- Healthcare (4 books): Medical technology and health systems
- Gaming (4 books): AI in gaming and interactive entertainment
- Security (4 books): Cybersecurity and privacy frameworks
The library includes comprehensive readability analysis for all books using 6 industry-standard classic readability formulas (1940s-1970s era). These time-tested metrics provide reliable, interpretable assessments that correlate well with human readability judgments.
- Flesch Reading Ease (1948): 0-100 scale, higher scores indicate easier reading
- Flesch-Kincaid Grade Level (1975): Years of education needed to understand the text
- Gunning Fog Index (1952): Formal education years required for comprehension
- SMOG Index (1969): Simple Measure of Gobbledygook for grade-level estimation
- Automated Readability Index (1967): Character-based readability metric
- Coleman-Liau Index (1975): Alternative character-based assessment
Our implementation covers 6 of the 7 major classic readability formulas, providing comprehensive traditional assessment. See research/readabiliity_methods.md for detailed comparison with modern ML-based approaches and future enhancement possibilities.
Based on analysis of 182 books, the following targets improve accessibility while maintaining technical accuracy:
- Overall Composite Score: Target 50-70 (current: 16.6)
- Flesch Reading Ease: Target 60-70 (current: 0.5) - standard level for general audiences
- Grade Level Metrics: Target 12-16 years (current: 22+ years) - high school to college level
- Sentence Length: Target 12-18 words ✓ (current: 17.1 - already achieved)
Priority: Focus on vocabulary simplification and grade level reduction while preserving domain expertise.
- Main Dashboard: Visit
/readability-analysis.htmlfor library overview - Individual Reports: Each book has detailed readability metrics and recommendations
- API Access: Programmatic access via
/api/readability-analysis.js
- 182 books analyzed with complete readability profiles
- Average reading level: Graduate/Professional (22+ years education)
- Most readable: Tutorial and guide books
- Most challenging: Technical strategy and academic content
# Generate complete readability analysis
node scripts/readability-analyzer.js
# Generate individual book reports
node scripts/individual-readability-reports.jsAnalysis results are saved to analysis-results/ directory and automatically integrated into the web interface.
npm run generate-manifest # Scan books, update manifest, and generate sitemaps
npm run generate-toc # Generate table of contents for all books
npm run build-all # Complete build processThe manifest generator automatically creates and updates two sitemaps:
- Library Sitemap (
sitemap.xml): 200+ URLs for books, categories, and API endpoints - Podcast Sitemap (
sitemap-podcast.xml): 154+ URLs for podcast episodes from RSS feed
# Generate both sitemaps automatically
node scripts/generate-manifest.js
# Or generate podcast sitemap independently
node scripts/generate-podcast-sitemap.js- Add book directory to
books/withfull_book.md - Run
npm run generate-manifestto update catalog and both sitemaps - Test with
npm run test-server
- Library Sitemap: Automatically generated at
/public/sitemap.xml(accessible vialibrary.wardleymaps.ai/sitemap.xml) - Podcast Sitemap: Automatically generated at
/public/sitemap-podcast.xmlfrom RSS feed conversion - Auto-Updates: Both sitemaps regenerate whenever content changes (books added/removed or new podcast episodes)
- Coverage:
- Library: 200+ URLs including all books, categories, and API endpoints
- Podcast: 154+ URLs including episodes, pagination pages, and RSS feed
- Search Console: Submit both sitemaps to Google Search Console and Bing Webmaster Tools
The podcast sitemap is automatically generated from the live RSS feed:
- Source:
https://podcast.wardleymaps.ai/feed.xml - Episodes Discovered: 135+ podcast episodes with publication dates
- Additional Pages: Homepage, RSS feed, and 17 pagination pages
- Update Frequency: Syncs with RSS feed changes automatically
- Frontend: Vanilla JavaScript with modern ES6+ features
- Backend: Vercel serverless functions with manifest-based discovery
- Storage: Git-based content management with GitHub integration
- SEO: Automated XML sitemap generation for both library and podcast content
- RSS Integration: Live RSS-to-sitemap conversion with episode discovery
- Deployment: Automated Vercel deployment from Development branch
- Core: Node.js, vanilla JavaScript, Vercel serverless functions
- XML Processing:
xml2jsfor RSS feed parsing and sitemap generation - Testing: Custom test suite for API endpoints and content validation
- Build Tools: Automated manifest generation and content discovery
Comprehensive documentation is available in the docs/ directory:
- Development Guide - Complete documentation index
- Developer Notes - Architecture and development workflows
- Enhancement Roadmap - Planned features and implementation
- Manifest System - Book discovery and categorization
- Table of Contents - TOC generation system
# Run all tests
npm run test-all
# Test individual components
node tests/test-books.js # Book data verification
node tests/test-api-endpoints.js # API functionality
node tests/test-server.js # Local development serverWe welcome contributions! Please see our development guidelines:
- Branch Strategy: All development happens on the
Developmentbranch - Code Quality: Follow existing patterns and conventions
- Documentation: Update relevant docs for any changes
- Testing: Ensure all tests pass before submitting
git checkout Development
# Make your changes
npm run generate-manifest # Update manifest and both sitemaps if adding books
npm run test-all # Verify everything worksThis project is licensed under the MIT License - see the LICENSE file for details.
- Live Application: library.wardleymaps.ai
- Repository: GitHub
- Issues: Bug Reports & Features
This library serves the strategic thinking community by providing free access to high-quality Wardley Mapping and strategic analysis resources. Built with modern web technologies for optimal performance and user experience.
Empowering strategic thinking through accessible knowledge and interactive learning.