Servers App

Servers App

Servers App

The Servers App is the centralized server configuration management application for FlowState. It provides a dedicated interface for managing RxDB server connections used across all FlowState applications, including authentication, connection testing, and multi-server support.

Key Features

  • Server Management: Add, edit, and delete RxDB server configurations
  • Active Server Selection: Set and track the currently active server for replication
  • Authentication Integration: Login flow with email verification and token management
  • Connection Testing: Verify server connectivity before activating
  • Multi-tenant Support: Configure domain, user, and organization IDs per server
  • Status Indicators: Visual feedback for active/inactive and authenticated states

Target Users

User TypePrimary Use Cases
DevelopersConfigure development and staging servers
System AdministratorsManage production server connections
End UsersSwitch between servers, authenticate to sync data

Getting Started

The app provides a simple navigation structure:

  • Server List (/) - Main server management page with CRUD operations
  • Login (/login/:serverName) - Server-specific authentication page

Adding Your First Server

  1. Click the "Add Server" button (or press Cmd/Ctrl+N)
  2. Default development server settings are pre-filled
  3. Customize the server name, URL, and database name
  4. Optionally test the connection
  5. Save to create the server configuration
  6. Click "Set Active" to use this server for replication

Authenticating with a Server

  1. Find the server in the list
  2. Click the "Login" button in the Auth column
  3. Enter your email address
  4. Check your email for the verification code
  5. Enter the code to complete authentication
  6. The server will show "Authenticated" status

App Identity

PropertyValue
Package@epicdm/flowstate-app-servers
Base Path/apps/servers
Iconserver
Color#F59E0B
Previous
Changelog
Next
Getting Started