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