Vim Dojo

Practice Vim. Don't learn Vim.

A browser playground for building muscle memory on ordinary editing tasks. It is not a beginner tutorial. New to Vim? Start with VimHero Basic Movement.

ROADMAP.md is the learning plan. Category play, random review, a daily kata, and interactive hints are in the dojo. Guided replay is next.

Add a challenge

This project grows when people add realistic cases.

1. Fork the repo.
2. Append a case to the matching file in src/challenges/.
3. Run npm test and npm run dev.
4. Open a pull request.

CONTRIBUTING.md has the template, field rules, and how to add a new category.

Play locally

npm install
npm test
npm run dev

Embed

import { mountVimDojo } from 'vim-dojo';

mountVimDojo(document.querySelector('#dojo'), {
  basePath: '/vim',
});

Query params: ?category=motion, ?category=macro, ?mode=daily (or ?daily). Use the Shuffle button or :shuffle to randomize challenges. Deep-link a case with ?challenge=motion-01.

The host can theme it with --accent, --black, --gray, --gray-light, --gray-dark, --bg, and --surface. Invert the RGB triples for dark mode.

"vim-dojo": "github:sabililhaq/vim-dojo#v0.1.9"