How nkminion/flowstate works
FlowState is a collaborative workspace and Kanban-style board app. Users sign in with Google or GitHub, enter workspaces, manage boards, and organize cards into ordered lists; board membership and roles govern collaboration. The web pages call an Express API, which uses PostgreSQL for application data and sessions for selected workspace/board context. Separate user-facing capabilities include inbox notifications and workspace activity history. The source excerpts show the API and several UI requests, but not the full schema or all handlers, so some subsystem relationships are documented only at the UI boundary.
Main entry points: index.js Express API · db.js Database access · server.js Page serving · login_script.js Sign-in page
Components 20
Web interface
- Page serving
Server/server.js - Sign-in page
public/login_script.js - Workspace home
public/home_script.js - Workspace page
public/workspace_script.js - Board page
public/boards_script.js - Inbox page
public/inbox_script.js - History page
public/history_script.js
API and identity
- Express API
Server/index.js - OAuth providers
- Session context
Server/index.js - Database access
Server/src/config/db.js - PostgreSQL
Workspace collaboration
- Workspace management
Server/index.js - Workspace membership
Server/index.js
Board workflow
- Board management
Server/index.js - Lists and cards
Server/index.js - Board roles
Server/index.js
User records
- Inbox notifications
Server/index.js - Workspace history
Server/index.js
Other components
- User
Connections 29
- User → Page serving: opens pages
Server/server.js - Page serving → Sign-in page: serves login
Server/server.js - Page serving → Workspace home: serves home
Server/server.js - Page serving → Workspace page: serves workspace
Server/server.js - Page serving → Board page: serves board
Server/server.js - Sign-in page → Express API: starts sign-in
public/login_script.js - Express API → OAuth providers: authenticates with
Server/index.js - Workspace home → Express API: requests workspaces
public/home_script.js - Workspace page → Express API: manages boards
public/workspace_script.js - Board page → Express API: manages board
public/boards_script.js - Inbox page → Express API: loads notifications
public/inbox_script.js - History page → Express API: loads history
public/history_script.js - Express API → Session context: reads context
Server/index.js - Express API → Database access: queries data
Server/index.js - Database access → PostgreSQL: executes queries
Server/src/config/db.js - Express API → Workspace management: handles requests
Server/index.js - Express API → Workspace membership: handles requests
Server/index.js - Express API → Board management: handles requests
Server/index.js - Express API → Lists and cards: handles requests
Server/index.js - Express API → Board roles: handles requests
Server/index.js - Express API → Inbox notifications: handles requests
Server/index.js - Express API → Workspace history: handles requests
Server/index.js - Workspace management → Database access: queries data
Server/index.js - Workspace membership → Database access: queries data
Server/index.js - Board management → Database access: queries data
Server/index.js - Lists and cards → Database access: queries data
Server/index.js - Board roles → Database access: queries data
Server/index.js - Inbox notifications → Database access: queries data
Server/index.js - Workspace history → Database access: queries data
Server/index.js