DigitableCourses
Founding Edition · v0.1.0 · toolchain

Setup assistant

Four steps: platform, palette, tool set — and a ready command for bootstrap.sh together with the list of theme files and the paths they land in.

You can install and configure all of this by hand, for free: the Digitable Focus configs are open — they sit in full in the integration cards, and the tool list is visible right here. The archive is bought for something else: the Compendium, the templates and an installer that lays 69 targets out across your directories on its own.

  1. Step 1 of 4 What do you work on

    The platform decides both which targets exist at all and how they are installed: iTerm2 is macOS only, Windows Terminal is Windows only, and in the manifest every tool spells its installation out per package manager.

    Package manager

    The manager is detected by bootstrap.sh itself — there is no flag for it and none is needed. The choice here only shows what will actually be installed and what the script will move into its “install by hand” section.

  2. Step 2 of 4 The Digitable Focus palette

    One palette for every target at once. The value goes into the --palette flag and is substituted into theme file names: digitable-focus-{palette}.conf.

    The palette can be changed later: re-running with a different --palette is idempotent, and files that differ are kept next to the originals with a .digitable-backup-<timestamp> suffix.

  3. Step 3 of 4 What to install

    The manifest holds 69 tools in 10 categories; 18 of them are the base set, the rest are marked optional and are not installed without an explicit choice.

    The tool list loads when you reach this step. Without JavaScript, open the whole manifest: setup-toolchain.json.

  4. Step 4 of 4 Command and files

    The commands are assembled from your choices. The first one changes nothing — it prints a plan and exits; the second one installs. Run them from the toolchain/ directory of the unpacked archive.

    What the installer does
    The plan firstinstalls nothing
    cd Digitable-Workbench-Founding-Edition-v0.1.0/toolchain
    bash bootstrap.sh --palette carbon --plan
    Installationidempotent, with a backup of replaced files
    cd Digitable-Workbench-Founding-Edition-v0.1.0/toolchain
    bash bootstrap.sh --palette carbon --yes

    Theme files and where they land

    The list of paths appears once the manifest is loaded. The destination paths are also in the integration cards: the configs themselves are there too.

      Theme placement in bootstrap.sh ignores --categories and --tools: a theme is written for every target the script finds on the system. Shown here is the set from your choices — the rest are added automatically if the tool is already installed.

      Ready-made commands, no wizard at all
      macOS, base set, plan
      bash bootstrap.sh --palette carbon --plan
      Linux, shell and git, install
      bash bootstrap.sh --palette paper --categories shell,git --yes
      Windows (Git Bash), terminal only
      bash bootstrap.sh --palette signal --tools windows-terminal --yes
      Just spread the themes over whatever is already installed
      bash bootstrap.sh --palette carbon --skip-install --yes
      Every flag
      bash bootstrap.sh --help

      Everything listed above installs and configures for free and by hand: the tools are ordinary packages, and the Digitable Focus configs are open and published on the product page in full. What you pay for is the assembled archive: the Compendium, the templates and an installer that does this work for you and knows how to roll back.