@interstitial/design

Design tokens (CSS custom properties) for Interstitial product surfaces. See DESIGN.md for how to use and evolve the system.

Contents

• tokens.css — import this in the app’s global stylesheet
• DESIGN.md — reference: principles, consumption, Tailwind convention, change control

Local development in planetary-software-workspace

This folder can be a git repo and a submodule of the workspace (sibling to planetary-software, ps-atlas, infra).

Create the GitHub repository

1. On GitHub, create an empty repo: interstitial-systems/design (no README, no .gitignore).

2. From this directory:

   cd design
   git init
   git add .
   git commit -m "Initial commit: design tokens and DESIGN.md"
   git branch -M main
   git remote add origin https://github.com/interstitial-systems/design.git
   git push -u origin main

Link as a submodule (workspace root)

git submodule add needs an empty path, so if you already have this folder in the workspace with its own .git, either push first then replace with submodule, or add submodule into a clean clone.

After the remote exists and you have pushed:

cd /path/to/planetary-software-workspace
# If `design` was only local files, back it up, remove it, then:
rm -rf design
git submodule add https://github.com/interstitial-systems/design.git design
git commit -m "chore: add design token repo as submodule"

If you initialized git inside design/ here, delete the folder after push and run git submodule add so the parent records the submodule commit (or use Git’s workflow for “submodule from existing local repo” that you prefer).

Publishing (optional)

For CI or non-monorepo consumers (e.g. Atlas alone), publish to npm or GitHub Packages and depend with semver:

"@interstitial/design": "^0.1.0"

Keep private: true in this repo until the scope and registry are decided.