This document outlines the roadmap for version 0.2, including internal module refactoring, plugin architecture planning, and features to implement.

• Full project structure with Next.js 15 + React 19
• 9-step setup wizard UI
• White-label branding system with 10+ theme presets
• AppConfig data model and localStorage persistence
• Authentication system (dev mode with 8 test users)
• Database schema with RBAC (PostgreSQL + Hasura)
• 4 platform templates (Slack, Discord, WhatsApp, Telegram)
• 70+ UI components (Radix UI based)
• Documentation for GitHub Wiki
• CI/CD pipelines (GitHub Actions)
• Docker support
• Platform build configs (Electron, Tauri, Capacitor, React Native)

• TypeScript strict mode warnings (non-blocking)
• ESLint warnings in some files (non-blocking)
• E2E tests skipped (requires backend)
• Vercel deployment not configured
• Some type mismatches in API routes

Refactor code into modular, testable units while keeping them internal to nself-chat.

src/modules/
├── auth/           # Authentication module
│   ├── providers/  # Auth providers (email, Google, GitHub, etc.)
│   ├── hooks/      # useAuth, useSession
│   └── services/   # AuthService interface
├── messaging/      # Core messaging
│   ├── hooks/      # useMessages, useChannels
│   ├── services/   # MessageService
│   └── stores/     # Zustand stores
├── realtime/       # Real-time features
│   ├── socket/     # Socket.io integration
│   ├── presence/   # User presence
│   └── typing/     # Typing indicators
├── files/          # File handling
│   ├── upload/     # Upload service
│   ├── storage/    # Storage adapters
│   └── preview/    # File previews
├── notifications/  # Notification system
│   ├── push/       # Push notifications
│   ├── email/      # Email notifications
│   └── in-app/     # In-app notifications
└── config/         # Configuration module
    ├── app-config/ # AppConfig management
    ├── themes/     # Theme system
    └── branding/   # White-label config

These are candidates for extraction as generic @nself/plugin-* packages for use in other nself projects.

• Fix type mismatches in API routes
• Add proper types for all props
• Enable strict mode progressively
• Fix ESLint errors

• Create src/modules/ directory structure
• Extract auth into module
• Extract messaging into module
• Extract config into module
• Update imports across codebase

• Complete Socket.io integration
• Add presence indicators
• Add typing indicators
• Add real-time message updates

• Complete Nhost auth integration
• Add session management
• Add refresh token handling
• Add logout functionality

• Complete MinIO integration
• Add file upload UI
• Add file preview
• Add image optimization

• Set up E2E test environment
• Write component tests
• Write integration tests
• Add API tests

When extracting plugins, they should follow this interface:

interface NselfPlugin {
  name: string
  version: string

  // Lifecycle hooks
  onInit?: (context: PluginContext) => Promise<void>
  onDestroy?: () => Promise<void>

  // UI Components
  components?: Record<string, React.ComponentType>

  // API Routes
  routes?: RouteDefinition[]

  // GraphQL Extensions
  schema?: string
  resolvers?: Record<string, any>

  // Event Handlers
  handlers?: EventHandler[]

  // Configuration Schema
  configSchema?: ZodSchema
}

1. Module structure - Imports will change from @/components/* to @/modules/* for core features
2. Config format - AppConfig may be restructured for better organization
3. Auth interface - AuthService interface may change for better extensibility

See docs/Contributing.md for how to contribute to nself-chat.

• v0.2-alpha: Module refactoring complete
• v0.2-beta: Real-time features working
• v0.2-rc: All tests passing
• v0.2.0: Production-ready release

Last updated: 2026-01-29