whatisgithub

What is lockstep?

caglaryalcin/lockstep — explained in plain English

Analysis updated 2026-05-18

38TypeScriptAudience · generalComplexity · 2/5Setup · easy

In one sentence

A self hosted web app for tracking your personal security checklist, habits, and progress with per user profiles and a Docker friendly setup.

Mindmap

mindmap
  root((Lockstep))
    What it does
      Security checklist tracking
      Per user progress
      Dashboard with priorities
    Tech stack
      TypeScript
      Docker
    Use cases
      Track personal security habits
      Self host for a small group
      Deploy with Docker Compose
    Audience
      Security minded individuals
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Track your personal security habits and checklist progress with per user profiles

USE CASE 2

Self host a private security checklist dashboard for yourself or a small group

USE CASE 3

Deploy the checklist with Docker Compose or Docker Stack and persist data with a volume

What is it built with?

TypeScriptDocker

How does it compare?

caglaryalcin/lockstepdiegosouzapw/omniglyphdjdeveloperr/nativescript-expo
Stars383838
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Uses a single JSON file for storage by default, move to a database like PostgreSQL for multiple instances.

So what is it?

Lockstep is a personal security checklist app that helps you track your own digital security habits over time. It presents a set of security related tasks organized into categories with priority levels, and lets you check items off as you complete them, filter the list, and watch your overall progress on a dashboard. Each user has their own login and profile, so progress is tracked per person rather than shared across everyone using the same installation. The interface supports both dark and light mode, and it also has a Turkish language option alongside English. The app is built with TypeScript and is meant to run as a small self hosted web service rather than a cloud product you sign up for. You can start it locally by installing dependencies with npm, building the project, and running the built in server, which listens on a local port that can be changed with an environment variable. There is also a ready made Docker image, so you can run it in a container with a single command, mounting a data folder so your accounts and progress survive restarts and updates. A Docker Compose and Docker Stack setup are included as well for slightly larger deployments. By default anyone can create a new account, which makes sense for trying it out, but for a public facing installation there is a setting to turn registration off after the first account is made, so it becomes login only. User accounts, password hashes, profile settings, and checklist progress are all saved to a single JSON file on the server, and the README recommends running only one instance at a time with this storage method, moving to a real database like PostgreSQL if you need multiple instances. The actual checklist content lives in a separate YAML file, so changing what appears on the checklist means editing that file and rebuilding the app.

Copy-paste prompts

Prompt 1
Help me deploy Lockstep with Docker and persist user data using a volume.
Prompt 2
Show me how to disable new account registration after my first account is created.
Prompt 3
Explain how to edit personal-security-checklist.yml and rebuild the app with my own checklist items.

Frequently asked questions

What is lockstep?

A self hosted web app for tracking your personal security checklist, habits, and progress with per user profiles and a Docker friendly setup.

What language is lockstep written in?

Mainly TypeScript. The stack also includes TypeScript, Docker.

How hard is lockstep to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is lockstep for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.