git404hub

what is lockstep fr?

caglaryalcin/lockstep — explained in plain English

Analysis updated 2026-05-18

38TypeScriptAudience · generalComplexity · 2/5Setup · easy

tl;dr

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

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

what's the stack?

TypeScriptDocker

how it stacks up fr

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 i run it?

Difficulty · easy time til it works · 30min

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

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.