A text-mode web browser with AI help, inspired by Lynx, plus TextFirst.css for text-first websites.
Documentation Index
Complete guide to all documentation in DBBasic TextBrowser
Start Here 🚀
New to the project? Start with these:
- README.md - Project overview and features
- QUICKSTART.md - Get started in 5 minutes
- demo/index.html - Interactive demo of TextFirst.css
Project Status 📊
Current state and metrics:
- PROJECT-STATUS.md - Complete project overview
- Executive summary
- All completed milestones
- Technical metrics (28 tests, 13 KB CSS)
- File structure
- Comparison with modern frameworks
- Future roadmap
- SESSION-SUMMARY.md - Original development session
- What we built
- Why we built it
- Test suite details
- Philosophy discovered
- CONTINUATION-SUMMARY.md - Continued session
- Verification and validation
- Key insights captured
- Documentation created
- Final polish
Technical Documentation 🔧
TextFirst.css Framework
- SEMANTIC-CSS-FRAMEWORK.md - Framework philosophy
- The Tri-Hard Pattern (and why it's bad)
- Progressive enhancement
- Comparison: 1997 vs 2025 Tailwind vs TextFirst.css
- Why 13 KB beats 3 MB
- Semantic HTML specification
- TEXT-WEB-HTML.md - HTML tag reference
- New semantic tags (
<color>,<box>,<banner>,<status>) - Enhanced old tags (
<font color>,<center>,<menu>) - Implementation guide
- Browser compatibility
- Usage examples
Testing
- tests/README.md - Test documentation
- 11 unit tests
- 17 integration tests
- Coverage details
- How to run tests
Philosophy & History 📚
Why Text-First Matters
- IT-JUST-WORKS.md - The irony of simplicity
- Basic HTML/CSS working everywhere is remarkable in 2025
- Build process comparison
- "Works on my machine" problem solved
- The return to sanity
- IDEAS.md - Original design philosophy
- Why text browsers matter
- Bridging BBS ANSI with HTML colors
- AI integration rationale
Historical Context
- WEB-DESIGN-HISTORY.md - Web evolution 1995-2025
- Era 1: Simple HTML (1995-1999)
- Era 2: Photoshop Slicing Disaster (2000-2005)
- Era 3: CSS/JS Separation (2006-2010)
- Era 4: Responsive Design (2011-2015)
- Era 5: Framework Explosion (2016-2020)
- Era 6: Build Tool Hell (2021-2024)
- Era 7: Back to Simple (2025+)
- MOBILE-WEB-HISTORY.md - Mobile web complexity cycle
- WAP/WML era (1999-2007)
- Separate mobile sites (2007-2010)
- Responsive design (2010-2015)
- Framework complexity (2015-2025)
- Back to responsive (2025+)
Case Studies
- USEIT-PARADOX.md - Jakob Nielsen's site
- Old site: perfectly usable, < 1 second load
- New site: slower, less usable, but "prettier"
- Performance comparison
- What they lost (differentiation, free marketing)
- The stakeholder trap
- Lessons for DBBasic TextBrowser
By Use Case 🎯
I want to...
...understand the project quickly → Start: README.md → Then: QUICKSTART.md
...see it in action → Demo: demo/index.html → Open in browser and text browser to compare
...understand the philosophy → Read: SEMANTIC-CSS-FRAMEWORK.md → Then: IT-JUST-WORKS.md
...learn from history → Read: WEB-DESIGN-HISTORY.md → Then: USEIT-PARADOX.md
...use TextFirst.css → Start: QUICKSTART.md → Reference: TEXT-WEB-HTML.md → Demo: demo/index.html
...contribute → Tests: tests/README.md → Status: PROJECT-STATUS.md → Philosophy: SEMANTIC-CSS-FRAMEWORK.md
...understand test coverage → Read: tests/README.md → Run: pytest tests/ -v
...understand why this matters → Read: USEIT-PARADOX.md → Then: IT-JUST-WORKS.md
By Topic 📖
Browser Features
- README.md - Feature overview
- QUICKSTART.md - Controls and usage
- IDEAS.md - Design rationale
CSS Framework
- SEMANTIC-CSS-FRAMEWORK.md - Philosophy
- TEXT-WEB-HTML.md - Tag reference
- demo/index.html - Live examples
- textfirst.css - Source code
Testing
- tests/README.md - Test documentation
- tests/test_browser.py - Unit tests
- tests/test_integration.py - Integration tests
History & Context
- WEB-DESIGN-HISTORY.md - Web evolution
- MOBILE-WEB-HISTORY.md - Mobile evolution
- USEIT-PARADOX.md - Case study
Philosophy
- SEMANTIC-CSS-FRAMEWORK.md - Tri-Hard Pattern
- IT-JUST-WORKS.md - Simplicity wins
- IDEAS.md - Original vision
Project Management
- PROJECT-STATUS.md - Current state
- SESSION-SUMMARY.md - Development session
- CONTINUATION-SUMMARY.md - Follow-up session
By Reading Time ⏱️
Quick (5 minutes)
Medium (15 minutes)
Deep Dive (30+ minutes)
File Sizes & Stats 📈
| File | Size | Lines | Purpose |
|---|---|---|---|
| README.md | ~15 KB | 287 | Main documentation |
| QUICKSTART.md | ~18 KB | 325 | Getting started |
| PROJECT-STATUS.md | ~20 KB | 280 | Status report |
| SEMANTIC-CSS-FRAMEWORK.md | ~35 KB | 500+ | Framework philosophy |
| TEXT-WEB-HTML.md | ~25 KB | 400+ | HTML reference |
| IT-JUST-WORKS.md | ~20 KB | 325 | Simplicity essay |
| USEIT-PARADOX.md | ~45 KB | 900+ | Case study |
| WEB-DESIGN-HISTORY.md | ~40 KB | 600+ | Historical context |
| MOBILE-WEB-HISTORY.md | ~50 KB | 800+ | Mobile history |
| SESSION-SUMMARY.md | ~15 KB | 270 | Dev session notes |
| CONTINUATION-SUMMARY.md | ~12 KB | 280 | Follow-up notes |
| tests/README.md | ~8 KB | 150 | Test docs |
Total documentation: ~300 KB, ~5,500+ lines
Key Concepts 🔑
The Tri-Hard Pattern
Splitting simple tasks across HTML + CSS + JavaScript + build configs. Makes everything harder.
Read: SEMANTIC-CSS-FRAMEWORK.md
Progressive Enhancement
HTML works standalone. CSS enhances. JavaScript is optional.
Read: IT-JUST-WORKS.md
Text-First Web
Pages that work in text browsers, enhanced for graphical browsers.
Read: TEXT-WEB-HTML.md
Differentiation > Conformity
Being remarkable beats being generic. useit.com learned this the hard way.
Read: USEIT-PARADOX.md
Simple > Complex
Until complexity is necessary. 13 KB beats 3 MB.
Read: SEMANTIC-CSS-FRAMEWORK.md
Learning Paths 🎓
Path 1: Practical User
- README.md - What is this?
- QUICKSTART.md - How do I use it?
- demo/index.html - Show me examples
- TEXT-WEB-HTML.md - Tag reference
Path 2: Philosophy Student
- IT-JUST-WORKS.md - Why simplicity matters
- SEMANTIC-CSS-FRAMEWORK.md - The Tri-Hard Pattern
- USEIT-PARADOX.md - Real-world case study
- WEB-DESIGN-HISTORY.md - Historical context
Path 3: Developer/Contributor
- PROJECT-STATUS.md - Current state
- tests/README.md - Test coverage
- SEMANTIC-CSS-FRAMEWORK.md - Design principles
- TEXT-WEB-HTML.md - Implementation details
Path 4: Historical Context
- WEB-DESIGN-HISTORY.md - Web evolution
- MOBILE-WEB-HISTORY.md - Mobile evolution
- USEIT-PARADOX.md - What went wrong
- IT-JUST-WORKS.md - Back to simple
Quotes to Know 💬
From the documentation:
"Somehow you captured modern and classic balance. Looks good, easy to read, lightweight, basic enough to read and edit manually if needed." - User feedback
"The funny thing is nngroup lost what made them special and an example and talking point of the web by 'fixing it'" - On differentiation
"Basic HTML and CSS works on Safari and Firefox. Funny." - On the irony of simplicity
"Don't lose what makes you special by trying to look like everyone else." - Core lesson
External Resources 🔗
- Lynx browser: http://lynx.browser.org/
- Jakob Nielsen: https://www.nngroup.com/
- Web Archive (old useit.com): https://web.archive.org/
- HTML Standards: https://html.spec.whatwg.org/
Navigation Tips 🧭
- Start broad, go deep - README → QUICKSTART → specific topics
- Follow your interest - Practical? Philosophy? History? Pick your path
- Use the demo - Best way to understand is to see it work
- Read the case study - USEIT-PARADOX.md teaches the most important lesson
Last Updated: 2025-01-28
Total Documentation: 12 files, ~5,500 lines, comprehensive coverage
Status: Complete and ready to use ✅