FMCD Dashboard

A multi-tenant dashboard for Fedimint Client Daemon (FMCD) built with Next.js and Stack Auth. This dashboard enables teams to manage their FMCD instances, connect to federations, and monitor balances in a pivate, collaborative environment.

Landing Page

Quick Overview

Manage Federations

Features

FMCD Integration

• Team-based FMCD Instances: Each team can configure their own FMCD instance with secure credential storage
• Federation Management: Connect to federations using invite codes and view federation details
• Real-time Balance Tracking: Monitor Bitcoin balances across all connected federations
• Admin Controls: Team administrators manage FMCD instance configuration
• Secure Communication: All FMCD requests are proxied server-side with encrypted credentials

Multi-tenancy

• Team Management: Create and manage multiple teams powered by Stack Auth
• Role-based Permissions: Team admins can configure FMCD settings, all members can view data and connect federations
• Team Isolation: Each team's FMCD configuration and data is completely isolated

Tech Stack

• Next.js 15 with App Router
• TypeScript with strict mode
• Tailwind CSS & Shadcn UI components
• Stack Auth for authentication and team management
• FMCD integration for Bitcoin wallet functionality
• Dark mode support

Getting Started

1. Clone the repository

   git clone https://github.com/minmoto/team-fmcd.git
   cd team-fmcd

2. Install dependencies

   npm install

3. Register an account on Stack Auth, copy the keys from the dashboard, and paste them into the .env.local file. Then, enable "client team creation" on the team settings tab.

   If you want to learn more about Stack Auth or self-host it, check out the Docs and GitHub.

4. Start the development server and go to http://localhost:3030

   npm run dev

With Docker

For development with Docker (includes hot reload):

npm run docker

5. Configure FMCD instance for your team:
   • Create a team in the dashboard
   • Navigate to the Configuration page
   • Enter your FMCD instance URL (e.g., http://localhost:3333)
   • Enter the FMCD authentication password
   • Test the connection and save

FMCD Configuration

Prerequisites

• A running FMCD instance
• FMCD authentication password

Setting up FMCD for a Team

1. Navigate to the team dashboard
2. Go to Configuration page (team admins only)
3. Enter FMCD Base URL (e.g., http://localhost:3333 or https://your-fmcd-instance.com)
4. Enter FMCD authentication password
5. Click "Test Connection" to verify connectivity
6. Enable the integration and save

Connecting to Federations

1. Navigate to the Federations page
2. Click "Connect Federation" button
3. Enter the federation invite code
4. Click "Connect" to join the federation
5. View federation details and balance in the dashboard

Project Structure

• app/ - Next.js App Router pages and API routes
• components/ - Reusable React components including FMCD UI components
• lib/ - Utility functions, types, and FMCD integration logic
• app/api/team/[teamId]/fmcd/ - FMCD API proxy endpoints

Related Projects

• FMCD (Fedimint Client Daemon) - The Bitcoin wallet client daemon this dashboard integrates with
• Stack Auth - Open-source authentication and team management solution
• Shadcn UI - Re-usable component library
• Next.js - React framework for production

License

MIT