Skip to content
Klutch.sh Docs

Deploying Word Mastermind

Introduction

Word Mastermind is a self-hosted word guessing game inspired by the popular Wordle game. Players attempt to guess a five-letter word within a limited number of tries, receiving feedback on which letters are correct and in the right position. Host your own instance to play with custom word lists and share with friends.

Key highlights of Word Mastermind:

  • Classic Gameplay: Familiar word guessing mechanics loved by millions
  • Custom Word Lists: Add your own words for personalized puzzles
  • Daily Challenge: Automatic daily word selection
  • Statistics Tracking: Track your winning streaks and guess distributions
  • Share Results: Share your results without spoiling the answer
  • Dark Mode: Eye-friendly dark theme option
  • Mobile Responsive: Play on any device
  • Self-Hosted Privacy: No tracking or data collection

This guide walks through deploying Word Mastermind on Klutch.sh using Docker.

Why Deploy Word Mastermind on Klutch.sh

Deploying Word Mastermind on Klutch.sh provides several advantages:

Custom Experience: Create your own word lists for themed puzzles or inside jokes.

Always Available: Your game is accessible 24/7 from anywhere.

HTTPS by Default: Secure access with automatic SSL certificates.

Share with Friends: Give friends your custom URL for daily challenges.

Prerequisites

Before deploying Word Mastermind on Klutch.sh, ensure you have:

Deploying Word Mastermind on Klutch.sh

    Create Your Repository

    Create a new GitHub repository with a Dockerfile:

    FROM node:18-alpine AS builder
    

    WORKDIR /app
    RUN apk add --no-cache git \
        && git clone https://github.com/octokatherine/word-master.git . \
        && npm install \
        && npm run build
    

    FROM nginx:alpine
    COPY --from=builder /app/dist /usr/share/nginx/html
    

    EXPOSE 80

    Push to GitHub

    Push your Dockerfile to your GitHub repository.

    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

    Set the traffic type to HTTP with port 80.

    Deploy Your Application

    Click Deploy to build and launch Word Mastermind.

    Start Playing

    Access your game at your Klutch.sh URL and start guessing words. Share the URL with friends to challenge them.

Additional Resources

Conclusion

Word Mastermind on Klutch.sh gives you a private, customizable word puzzle game to share with friends and family. Host daily challenges, customize word lists, and enjoy the classic word-guessing gameplay without ads or tracking.