Deploying TeamMapper

Introduction

TeamMapper is a collaborative mind mapping tool that allows teams to brainstorm and organize ideas visually. With real-time collaboration features, TeamMapper makes it easy to work together on mind maps from anywhere.

Key highlights of TeamMapper:

• Real-Time Collaboration: Work together on mind maps simultaneously
• Intuitive Interface: Easy-to-use drag-and-drop editor
• Keyboard Shortcuts: Efficient creation with keyboard navigation
• Export Options: Export to various formats (PNG, SVG, JSON)
• No Account Required: Start mapping instantly
• Sharing: Share maps via unique URLs
• Undo/Redo: Full history support
• Customization: Color coding and styling options
• Responsive: Works on desktop and tablets
• Self-Hosted: Complete data ownership

This guide walks through deploying TeamMapper on Klutch.sh using Docker.

Why Deploy TeamMapper on Klutch.sh

Deploying TeamMapper on Klutch.sh provides several advantages:

Simplified Deployment: Klutch.sh automatically detects your Dockerfile and builds TeamMapper without complex orchestration.

Persistent Storage: Attach persistent volumes for your mind maps.

HTTPS by Default: Secure collaboration with automatic SSL certificates.

GitHub Integration: Connect your configuration repository for automatic redeployments.

Prerequisites

Before deploying TeamMapper on Klutch.sh, ensure you have:

• A Klutch.sh account
• A GitHub account with a repository for your TeamMapper configuration
• Basic familiarity with Docker and containerization concepts

Deploying TeamMapper on Klutch.sh

Create Your Repository

Create a new GitHub repository with a Dockerfile for TeamMapper:

FROM ghcr.io/b310-digital/teammapper:latest

ENV NODE_ENV=production
ENV POSTGRES_HOST=${POSTGRES_HOST}
ENV POSTGRES_DB=${POSTGRES_DB}
ENV POSTGRES_USER=${POSTGRES_USER}
ENV POSTGRES_PASSWORD=${POSTGRES_PASSWORD}

EXPOSE 3000

VOLUME ["/app/data"]

Push to GitHub

Initialize and push your repository to GitHub with your Dockerfile.

Create a New Project on Klutch.sh

Navigate to the Klutch.sh dashboard and create a new project.

Create a New App

Within your project, create a new app and connect your GitHub repository.

Configure HTTP Traffic

In the deployment settings:

• Select HTTP as the traffic type
• Set the internal port to 3000

Set Environment Variables

Configure the following environment variables:

Variable	Value
NODE_ENV	production
POSTGRES_HOST	Your PostgreSQL hostname
POSTGRES_DB	Your database name
POSTGRES_USER	Your database username
POSTGRES_PASSWORD	Your database password

Attach Persistent Volumes

Add the following volumes:

Mount Path	Recommended Size	Purpose
/app/data	5 GB	Mind map data

Deploy Your Application

Click Deploy to start the build process.

Access TeamMapper

Once deployment completes, access TeamMapper at your app URL.

Configuration

Creating Mind Maps

Start mapping:

1. Click Create New Map
2. Enter a title for your mind map
3. Add nodes by pressing Enter or clicking
4. Connect nodes with drag-and-drop

Keyboard Shortcuts

Efficient mapping with shortcuts:

• Enter - Add sibling node
• Tab - Add child node
• Delete - Remove node
• Ctrl+Z - Undo
• Ctrl+Y - Redo
• Ctrl+S - Save

Sharing Maps

Share with collaborators:

1. Click the Share button
2. Copy the unique URL
3. Send to team members
4. Collaborators can edit in real-time

Exporting

Export your mind maps:

1. Click Export
2. Choose format (PNG, SVG, JSON)
3. Download the file

Additional Resources

• TeamMapper GitHub Repository
• Klutch.sh Persistent Volumes
• Klutch.sh Deployments

Conclusion

Deploying TeamMapper on Klutch.sh gives you a collaborative mind mapping tool with automatic builds, persistent storage, and secure HTTPS access. Brainstorm and organize ideas with your team in real-time.