1.0.0-beta2

Refactor Platform Frontend v1.0.0-beta2

Second Public Beta Release

This release delivers major improvements to the coaching experience including real-time collaboration, a new What's Due dashboard, rich text editing enhancements, role-based UI updates, and numerous UX and bug fixes.

What's New

What's Due Dashboard

• New dashboard view: What's Due dashboard with coach toggle and action filters (#246)
• Upcoming sessions list: Shows today's upcoming sessions on the dashboard (#224)

Real-time Collaboration & SSE

• SSE frontend implementation: Real-time server-sent events integration (#238)
• Presence indicators: See who else is online and editing in real-time (#178)
• Collaboration cursor fixes: Fixed cursor bubbles not appearing in coaching notes (#230)
• TipTap connection stability: Fixed connection instability and presence indicator bugs (#254)

Rich Text Editing (TipTap) Improvements

• Markdown support: Full markdown support in the coaching notes editor (#213)
• Google Docs-style link popover: Improved link creation UX with BubbleMenu (#206, #208)
• Toolbar improvements: Fixed toolbar rendering, transitions, and missing buttons (#183, #191, #222)
• Improved note styling: Enhanced coaching notes text styling (#177)
• Initial load fix: Fixed TipTap timeout error with loading state and retry (#249)
• Session cleanup: TipTap session is now destroyed on logout (#185)

User Roles & Access Control

• User role UI updates: Interface updated to reflect the new role system (#212, #204)
• Admin-only members link: Members link restricted to Admin and SuperAdmin users (#239)

Coaching Session UX

• Navigation drawer state: Drawer state is now preserved during sessions (#202)
• Session selector improvements: Swapped Upcoming/Previous order, backend sorting (#167)
• View Session button: Join past sessions with visual indicator (#169)
• Copy session link: New context menu item and button to copy coaching session links (#141)
• Session title separator: Switched to '/' as the coaching session title separator (#186)
• Relationship selector sorting: Dropdown contents sorted alphabetically (#162)
• Conditional relationship selector: Show/hide based on context (#159)

User Experience

• Set primary organization: Users can set their primary organization (#209)
• Timezone on Profile page: Users can set their current timezone (#152)
• Local timezone for session editing: Session times display in user's configured timezone (#171)
• Login redirect preservation: Intended destination URL is preserved on login redirect (#158)
• Sidebar keyboard shortcut: Disabled accidental sidebar toggle shortcut (#139)
• Actions & Agreements tabs: Moved down next to coaching Notes for better UX (#163)

Testing

• Testing framework: Introduced testing framework with high-impact initial tests (#151)
• Multi-tab fix: Fixed opening same coaching session across two browser tabs (#149)

Bug Fixes

• Fix organization settings sidebar collapse (#240)
• Fix overarching goal overflow (#235)
• Fix coaching relationship sync when navigating between sessions (#231)
• Fix responsiveness with screen width resizing on dashboard and session pages (#227)
• Fix coaching notes timeout (#219)
• Fix relationship reset: Only reset current coaching relationship if organization changes (#210)

Security

• Patched Next.js and React for critical security vulnerabilities (#237)

Dependencies

• Bump next from 15.3.5 to 15.4.7 (#198)
• Bump axios from 1.11.0 to 1.12.0 (#197)

Infrastructure

• Domain migration: Updated to myrefactor.com (#173)
• Removed arm64 builds (#203)

Contributors

• @jhodapp
• @calebbourg

Full Changelog: 1.0.0-beta1...1.0.0-beta2

1.0.0-beta1

🚀 Refactor Platform Frontend v1.0.0-beta1

First Public Beta Release

We're excited to announce the first public beta release of the Refactor Coaching & Mentorship Platform frontend! This modern Next.js web application provides an intuitive, responsive interface for coaches, mentors, and coachees to manage their coaching relationships and sessions.

🎯 What's New

🏗️ Modern Frontend Architecture

• Next.js 15.2: Latest React framework with App Router and Server Components
• React 19: Cutting-edge React features with improved performance
• TypeScript: Full type safety throughout the application
• Responsive Design: Mobile-first approach that works on all devices

🎨 Beautiful User Interface

• Radix UI Components: Accessible, customizable component library
• Tailwind CSS: Utility-first styling with consistent design system
• Dark Mode Support: Seamless light/dark theme switching with next-themes
• shadcn/ui: Pre-built, beautiful components following design system principles
• Professional Branding: Integrated Refactor Group visual identity

🔐 Authentication & Session Management

• Secure Login Interface: Clean, professional login experience
• Session-based Authentication: Cookie-based authentication with automatic session management
• Protected Routes: Middleware-based route protection for authenticated areas
• User Navigation: Intuitive user menu with profile and logout options

📊 Dashboard Experience

• Coaching Session Overview: Visual dashboard showing all coaching sessions
• Quick Actions: Easy access to create new sessions and manage relationships
• Session Timeline: Chronological view of coaching interactions
• Real-time Updates: Live data synchronization using SWR

🤝 Coaching Relationship Management

• Relationship Selector: Easy switching between different coaching relationships
• Multi-tenant Support: Organization-based relationship management
• Coach-Coachee Pairing: Clear visualization of coaching partnerships
• Relationship History: Complete timeline of coaching interactions

📝 Rich Coaching Session Interface

• Collaborative Note Editor: Real-time collaborative editing with TipTap
• Rich Text Formatting: Full formatting support (headings, lists, links, code blocks)
• Live Collaboration: Multiple users can edit notes simultaneously
• Collaboration Cursors: See where other users are editing in real-time
• Auto-save: Automatic saving of session notes and content

🎯 Goal & Action Management

• Overarching Goals: Visual goal tracking and management interface
• Action Items: Create, edit, and track action items with status updates
• Progress Visualization: Clear visual indicators of goal and action progress
• Due Date Management: Calendar integration for deadline tracking
• Status Workflows: Intuitive status updates (Not Started, In Progress, Completed, Won't Do)

📋 Agreements & Documentation

• Agreement Management: Create and manage coaching agreements
• Document Organization: Structured approach to coaching documentation
• Form-based Input: User-friendly forms for all data entry

👥 User & Organization Management

• User Profiles: Complete user profile management and editing
• Password Updates: Secure password change functionality
• Organization Switching: Easy navigation between multiple organizations
• Member Directory: View and manage organization members
• Role-based Access: Different interfaces for coaches, coachees, and admins

🛠️ Technical Highlights

⚡ Performance & Developer Experience

• Turbopack: Ultra-fast development builds with Next.js Turbopack
• SWR Data Fetching: Intelligent caching and real-time data synchronization
• Zustand State Management: Lightweight, scalable state management
• Optimistic Updates: Immediate UI feedback with background API calls

🎨 Design System & Components

• Component Library: Reusable UI components
• Design Tokens: Consistent spacing, colors, and typography
• Animation: Smooth transitions and micro-interactions with Tailwind CSS

🔗 API Integration

• Type-safe API Client: Fully typed API integration with custom hooks
• Error Handling: Comprehensive error handling with user-friendly messages
• Loading States: Elegant loading indicators and skeleton screens
• Optimistic UI: Immediate feedback for better user experience

📱 Responsive Design

• Mobile-first: Optimized for mobile devices with progressive enhancement
• Tablet Support: Beautiful interface on tablets and larger screens
• Desktop Experience: Full-featured desktop interface
• Touch-friendly: Large touch targets and gesture support

🔧 Development Tools

• Hot Reload: Instant feedback during development
• ESLint Configuration: Code quality and consistency enforcement
• TypeScript Strict Mode: Maximum type safety and error prevention
• Component Development: Organized component structure with clear separation

🚀 User Experience Features

🎯 Coaching Session Workflow

• Session Creation: Streamlined session creation with relationship selection
• Note Taking: Rich text editor with collaborative features
• Action Planning: In-session action item creation and assignment
• Goal Tracking: Integration with overarching goals and progress tracking

📅 Calendar & Scheduling

• Date Pickers: Beautiful, accessible date selection components
• Timeline View: Chronological session and milestone visualization
• Due Date Tracking: Visual indicators for approaching deadlines

🔍 Navigation & Discovery

• Command Menu: Keyboard shortcuts for power users (Cmd+K)
• Sidebar Navigation: Collapsible sidebar with organized menu structure
• Search Functionality: Find sessions, actions, and content quickly

💬 Real-time Collaboration

• Live Editing: Multiple users can edit session notes simultaneously
• Presence Indicators: See who else is online and editing
• Conflict Resolution: Automatic handling of concurrent edits
• WebSocket Integration: Real-time updates using Hocuspocus and Y.js

🔮 What's Next

Looking ahead to v1.0.0 stable:

• Enhanced Dashboard: Analytics widgets and progress visualization
• Calendar Integration: Full calendar view with session scheduling
• Video Service Integration: Full calendar view with session scheduling
• Notification System: In-app notifications for important events
• Advanced Search: Full-text search across all content
• Reporting Interface: Progress reports and coaching analytics
• AI Companions: Experiments with using AI to compliment the coach and provide deeper insights for the coachee
• Breadcrumb Navigation: Clear location awareness

🧪 What's Beta About This Release

This beta release provides a complete coaching workflow but may have:

• Minor UI/UX refinements based on user feedback
• Additional accessibility improvements
• Performance optimizations for large datasets
• Extended mobile device testing and optimization

🚀 Getting Started

Prerequisites

• Node.js 18+ or compatible runtime
• Modern web browser (Chrome, Firefox, Safari, Edge)
• Active backend API connection

Development Setup

git clone https://github.com/refactor-group/refactor-platform-fe.git
cd refactor-platform-fe
npm install
npm run dev

Environment Configuration

Create a .env.local file with:

NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL="http"
NEXT_PUBLIC_BACKEND_SERVICE_HOST="localhost"
NEXT_PUBLIC_BACKEND_SERVICE_PORT=4000
NEXT_PUBLIC_BACKEND_API_VERSION="1.0.0-beta1"
NEXT_PUBLIC_TIPTAP_APP_ID="your-tiptap-app-id"

Production Deployment

The frontend is designed for containerized deployment and integrates seamlessly with the backend infrastructure.

🎨 Design Philosophy

Our frontend embodies these core principles:

• User-Centric Design: Every interface decision prioritizes the coaching experience
• Accessibility First: Inclusive design that works for all users
• Performance Matters: Fast, responsive interactions at every touch point
• Collaborative by Default: Built for real-time collaboration and shared experiences
• Professional Polish: Enterprise-grade interface suitable for professional coaching

🤝 Contributing

We welcome contributions to the frontend! Areas of focus:

• UI/UX improvements and accessibility enhancements
• Component library expansion
• Mobile experience optimization
• Performance and bundle size optimization

📞 Support

• Documentation: docs/
• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Full Changelog: https://github.com/refactor-group/refactor-platform-fe/commits/1.0.0-beta1

This frontend release represents a modern, accessible, and beautiful interface for the coaching and mentoring workflow. We've focused on creating an intuitive experience that enhances rather than complicates the coaching relationship. We're excited to gather feedback as we refine the experience toward our stable 1.0.0 release!

Release 1.0-rc1

First internal production Release

Features:

• Email based session cookie authentication
• Manage all International Coaching Federation entities:
  • Actions
  • Agreements
  • Overarching Goals
  • Coaching Sessions
  • Coaches
  • Coachees
• Rich formatting coaching notes