🎉 Phoenix TUI v0.1.0-beta.6 Released - Documentation Sprint Complete!

[kolkov]

Release Date: November 4, 2025
Status: Beta 6/? - 95% Complete (19/20 weeks)
Focus: Professional Documentation + CI Hardening

We're excited to announce v0.1.0-beta.6 - our documentation-focused release that makes Phoenix ready for broader community adoption! 🚀

---

📚 What's New: 10,568 Lines of Professional Documentation

Week 19 Documentation Sprint delivered comprehensive guides for developers:

For Developers Starting with Phoenix

• Getting Started Tutorial - Your first Phoenix TUI app in 10 minutes
• Building Components - Create custom UI components
• Advanced Patterns - Real-world architectural patterns

For Contributors & Advanced Users

• Architecture Patterns - DDD implementation deep dive
• Testing Guide - Achieve 90%+ coverage like we do
• Performance Guide - Optimization techniques (how we hit 29,000 FPS!)
• Contributing Guide - Join the Phoenix contributors

API References

Complete API documentation for all 10 modules:

• Style API - CSS-like styling
• Layout API - Flexbox layouts
• TEA API - Elm Architecture
• Render API - High-performance rendering
• Mouse API - Mouse interactions
• Clipboard API - Clipboard operations

---

🔧 CI/Quality Improvements

Made Phoenix more reliable across all platforms:

• ✅ macOS CI fixed - No more false positives in headless environments
• ✅ Windows stability - Flaky tests identified and handled properly
• ✅ WSL2 support - Race detector now works in WSL2 (Gentoo tested)
• ✅ Cross-platform vet - Platform-specific false positives eliminated

---

📊 Project Status

Metric	Value	Target
Progress	95% (19/20 weeks)	✅ On track
Test Coverage	91.8%	✅ 90%+ achieved
Performance	29,000 FPS	✅ 489x target
Documentation	10,568 lines	✅ Complete
CI Reliability	100% green	✅ All platforms

---

🚀 Try Phoenix Today!

# Install specific modules
go get github.com/phoenix-tui/phoenix/tea@tea/v0.1.0-beta.6
go get github.com/phoenix-tui/phoenix/components@components/v0.1.0-beta.6

# Or install all libraries
go get github.com/phoenix-tui/phoenix@v0.1.0-beta.6

Quick Start: Getting Started Tutorial

---

🎯 Why Phoenix?

Phoenix solves critical problems in existing TUI frameworks:

• ✅ Perfect Unicode/Emoji - No more width calculation bugs (lipgloss#562 fixed!)
• ✅ 10x Performance - 29,000 FPS vs ~60 FPS (differential rendering + caching)
• ✅ DDD Architecture - Clean, testable, extendable (not monolithic)
• ✅ 91.8% Test Coverage - Production-ready quality
• ✅ Comprehensive Docs - Everything you need to get started

Real-world validation: Successfully migrated production shell (GoSh) with zero Unicode issues and 10x rendering performance improvement! 🎉

---

🗺️ Roadmap: Almost There!

We're in the final stretch:

• ✅ Weeks 1-2: Foundation (planning, architecture)
• ✅ Weeks 3-8: Core libraries (core, style, tea)
• ✅ Weeks 9-12: Layout + Components
• ✅ Weeks 13-14: Render engine (29,000 FPS!)
• ✅ Weeks 15-16: Advanced features (mouse, clipboard)
• ✅ Week 19: Documentation Sprint ← WE ARE HERE 📍
• 🎯 Week 20: Final polish + v0.1.0 FINAL (November 2025)

Next: One more week of polish and bug fixes, then v0.1.0 GA! 🚀

---

💬 Feedback Welcome!

We want to hear from you:

• 🐛 Found a bug? Open an issue
• 💡 Feature idea? Start a discussion
• 📖 Docs unclear? Let us know - we just wrote 10K+ lines and want them perfect!
• 🎉 Built something cool? Share it in Show and Tell!

---

📖 Learn More

• Release Notes - Full changelog
• ROADMAP.md - Project roadmap
• CHANGELOG.md - Version history
• Migration Guide - Coming from Charm ecosystem?

---

🙏 Thank You

To everyone who provided feedback on previous betas - your input shaped this release! Special thanks to the GoSh team for real-world validation.

Let's build the future of Go TUI together! 🚀

---

Phoenix TUI Framework - Rising from the ashes of legacy frameworks 🔥