🚀 Announcing Phoenix TUI Framework v0.1.0 - Production Ready!

[kolkov]

We're thrilled to announce the first stable release of Phoenix TUI Framework! After 20 weeks of intensive development, Phoenix v0.1.0 is production-ready and available now.

🎯 What is Phoenix?

Phoenix is a modern Terminal User Interface framework for Go that combines:

• High performance: 29,000 FPS rendering (489x faster than 60 FPS target)
• Perfect Unicode support: Fixes the long-standing Charm/Lipgloss emoji width issues
• Clean architecture: Domain-Driven Design with 91.8% test coverage
• Zero TUI dependencies: Built on stdlib + platform APIs only
• Type-safe: Leverages Go 1.25+ generics for compile-time safety

✨ Key Features

8 Production-Ready Libraries

• core - Terminal primitives with perfect Unicode handling
• style - CSS-like styling (border, padding, margin, colors)
• layout - Flexbox layout system
• tea - Type-safe Elm Architecture (MVU pattern)
• render - High-performance differential rendering
• components - Ready-to-use UI components (Input, List, Table, Modal, Progress)
• mouse - Full mouse interaction support
• clipboard - Cross-platform clipboard operations

Ready-to-Use Components

• ✅ TextInput & TextArea
• ✅ List & Viewport
• ✅ Table with sorting
• ✅ Modal dialogs
• ✅ Progress bars & Spinners

Professional Documentation

• 📚 10,568 lines of comprehensive documentation
• 📖 Complete API reference for all modules
• 🔧 Migration guide from Bubbletea
• ⚡ Performance optimization guide
• 🐛 Troubleshooting & FAQ

🚀 Quick Start

go get github.com/phoenix-tui/phoenix@v0.1.0

Hello World Example:

package main

import (
    "fmt"
    "github.com/phoenix-tui/phoenix/tea"
)

type model struct{ count int }

func (m model) Init() tea.Cmd { return nil }

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.KeyMsg:
        switch msg.String() {
        case "q": return m, tea.Quit
        case "up": m.count++
        case "down": m.count--
        }
    }
    return m, nil
}

func (m model) View() string {
    return fmt.Sprintf("Count: %d\n\nPress ↑/↓ to change, q to quit", m.count)
}

func main() {
    tea.NewProgram(model{}).Run()
}

📊 By The Numbers

• 45,000+ lines of production code
• 91.8% average test coverage (all modules >70%)
• 9/10 API quality score (validated against Go 2025 best practices)
• 10 production-ready modules
• 6 ready-to-use components
• 3 platforms supported (Windows, macOS, Linux)

🎯 Why Phoenix?

If you're using Charm/Bubbletea:

• ✅ Unicode/Emoji fixed - No more width calculation bugs (Lipgloss #562)
• ✅ 10x faster - High-performance differential rendering
• ✅ Type-safe - Generic Elm Architecture prevents runtime type errors
• ✅ Better organized - DDD architecture, clean module boundaries
• 📖 Migration guide available: MIGRATION_FROM_BUBBLETEA.md

If you're starting fresh:

• 🎓 Modern Go patterns - Generics, workspace mode, Go 1.25+
• 📚 Outstanding docs - Better than many established projects
• 🧪 Test coverage - 90%+ ensures reliability
• 🏗️ Production architecture - DDD, clean code, SOLID principles

🔮 Roadmap: What's Next?

v0.2.0 (Q1 2025):

• Signals integration (reactive programming with hybrid approach)
• Form components (Select, MultiSelect, Confirm)
• Theme system with presets
• Animation framework
• Grid layout system

📖 Resources

• 📦 Installation: go get github.com/phoenix-tui/phoenix@v0.1.0
• 📚 Documentation: docs/
• 🔧 API Reference: https://pkg.go.dev/github.com/phoenix-tui/phoenix@v0.1.0
• 🐛 Issues: https://github.com/phoenix-tui/phoenix/issues
• 💬 Discussions: https://github.com/phoenix-tui/phoenix/discussions
• 📝 Changelog: CHANGELOG.md

🙏 Try It & Give Feedback!

Phoenix v0.1.0 is production-ready, but we're following a cautious versioning strategy:

• v0.1.0 = First public release (API may evolve based on your feedback)
• v0.2.0, v0.3.0 = Iterations with community input
• v1.0.0 = API freeze with backwards compatibility guarantee (6-12 months)

We need your feedback! 🎯

Try Phoenix in your projects and let us know:

• What works well?
• What could be better?
• What features are you missing?
• How can we improve the API?

Your input will directly shape the path to v1.0.0!

💬 Join the Community

• 🐛 Found a bug? Open an issue
• 💡 Have an idea? Start a discussion
• ❓ Need help? Ask in Q&A
• 🎉 Built something cool? Show it off!

🌟 Star Us!

If you find Phoenix useful, please star the repository! It helps us understand community interest and prioritize development.

⭐ Star: https://github.com/phoenix-tui/phoenix

---

Happy Building! 🚀

The Phoenix Team

---

Links:

• Release Notes: https://github.com/phoenix-tui/phoenix/releases/tag/v0.1.0
• Full Changelog: https://github.com/phoenix-tui/phoenix/blob/main/CHANGELOG.md
• Getting Started: https://github.com/phoenix-tui/phoenix#quick-start

[alikebrahim]

Which llm built and documented all of this? Looks very chatgpt-ish