Phoenix TUI Framework v0.1.0-beta.4 Released

[kolkov]

Release Date: October 28, 2025
Status: Beta (API may change)
Installation: go get github.com/phoenix-tui/phoenix/tea@v0.1.0-beta.4

---

We're excited to announce the release of Phoenix TUI Framework v0.1.0-beta.4! This release brings significant API improvements, enhanced cross-platform reliability, and better developer experience.

Highlights

API Modernization (BREAKING CHANGE)

Phoenix now follows industry-standard API patterns inspired by Relica and OpenTelemetry:

Before (exposing internals):

import "github.com/phoenix-tui/phoenix/components/input/domain/model"
ta := model.NewTextArea()

After (clean public API):

import "github.com/phoenix-tui/phoenix/components/input"
ta := input.NewTextArea()

Benefits:

• ✅ Simpler imports - input.NewTextArea() instead of model.NewTextArea()
• ✅ Better pkg.go.dev documentation - internals hidden, public API visible
• ✅ DDD protected - /internal/ prevents external imports of implementation
• ✅ Industry standard - matches patterns from established Go projects

All 10 modules have been refactored with this pattern. See migration guide for upgrade instructions.

Performance Improvement (+5%)

Migrated type aliases to wrapper types, resulting in:

• Better compiler optimizations
• All methods/constants properly visible on pkg.go.dev
• Improved API discoverability

Component Enhancements

TextArea component now includes:

• ✅ Vertical scrolling with proper cursor positioning
• ✅ Professional ANSI reverse video cursor (\x1b[7m)
• ✅ Gray placeholder text for empty fields (RGB 88,88,88)
• ✅ 100% test coverage for new features

Cross-Platform Reliability

• Terminal cross-compilation fix (Unix stubs for Windows-specific functions)
• Pre-release checks now validate GOOS=linux builds
• Prevents "works on Windows, fails on Linux" scenarios
• CI validates all 10 modules on Linux, macOS, and Windows

Quality Metrics

• Files changed: 401
• Code changes: +6,334 / -4,777 lines
• Test coverage: 72.1-100% across modules (89.7% average)
• Platforms tested: Linux ✅ macOS ✅ Windows ✅
• Performance: 29,000 FPS rendering (489x faster than 60 FPS target)

Installation

# Individual modules (recommended)
go get github.com/phoenix-tui/phoenix/tea@v0.1.0-beta.4
go get github.com/phoenix-tui/phoenix/components@v0.1.0-beta.4
go get github.com/phoenix-tui/phoenix/style@v0.1.0-beta.4

# All 10 modules available:
# clipboard, components, core, layout, mouse, render, style, tea, terminal, testing

Multi-module monorepo: Each module can be imported independently. Use only what you need!

Breaking Changes

Import paths have changed for all modules. The migration is straightforward:

// Before v0.1.0-beta.4:
import "github.com/phoenix-tui/phoenix/components/input/domain/model"
import "github.com/phoenix-tui/phoenix/style/domain/model"

// After v0.1.0-beta.4:
import "github.com/phoenix-tui/phoenix/components/input"
import "github.com/phoenix-tui/phoenix/style"

Automated migration using gofmt -r:

gofmt -r 'model.NewTextArea -> input.NewTextArea' -w .
gofmt -r 'model.NewStyle -> style.New' -w .

See complete migration guide in CHANGELOG.md.

What's Next

Week 15-16: Advanced features

• Mouse hover events + drag-scrolling
• Clipboard enhancements (images, rich text)
• Additional example applications

Week 17-18: Real-world validation

• GoSh shell migration to Phoenix
• Production workload testing
• API refinement based on feedback

Week 19-20: v0.1.0 Launch

• Complete documentation
• Migration guides from Bubbletea
• Production-ready announcement

Documentation

• CHANGELOG.md - Complete release notes
• README.md - Project overview
• pkg.go.dev - API documentation
• GitHub Releases - Release page

Feedback Welcome!

Phoenix is in beta and we're actively seeking feedback:

• 💬 Questions: GitHub Discussions Q&A
• 🐛 Bug Reports: GitHub Issues
• 💡 Feature Requests: GitHub Discussions Ideas
• 🚀 Show & Tell: GitHub Discussions Show & Tell

Note: This is a beta release. API may change based on community feedback. Breaking changes are acceptable until v0.1.0 stable.

Why Phoenix?

Phoenix solves critical issues in existing TUI frameworks:

• ✅ Perfect Unicode/Emoji support - No more layout bugs
• ✅ 10x Performance - 29,000 FPS rendering with differential updates
• ✅ DDD Architecture - Clean, testable, extendable code
• ✅ Rich Components - Production-ready UI components
• ✅ Type-Safe - Modern Go 1.25+ patterns with generics
• ✅ Well-Tested - 90%+ test coverage across all modules
• ✅ Multi-Module - Use only what you need, no bloat

Try It Out

package main

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

type model struct {
    textInput input.TextInput
}

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:
        if msg.String() == "ctrl+c" {
            return m, tea.Quit
        }
        m.textInput = m.textInput.Update(msg)
    }
    return m, nil
}

func (m model) View() string {
    return fmt.Sprintf("Enter text: %s\n\nPress Ctrl+C to quit",
        m.textInput.View())
}

func main() {
    p := tea.NewProgram(model{
        textInput: input.NewTextInput().WithPlaceholder("Type here..."),
    })
    p.Run()
}

Thank You

Thank you to everyone who has contributed to Phoenix! Special thanks to the Go community for feedback and support.

---

Links:

• Repository: https://github.com/phoenix-tui/phoenix
• Documentation: https://pkg.go.dev/github.com/phoenix-tui/phoenix
• Releases: https://github.com/phoenix-tui/phoenix/releases
• Discussions: https://github.com/phoenix-tui/phoenix/discussions

Stay tuned for v0.1.0 stable release coming soon! 🚀