README.md

Cubing icons and fonts

Documentation and demo

https://icons.cubing.net

Development

Most development is simply adding/changing existing SVG files under the ./src/svg directory. If you haven't dealt with SVG files before, check out Inkscape.

If you want to actually build a font or CSS locally, you'll need some more tooling.

Build the project

You'll need bun to install development dependencies and build the project. Check out and build the project as follows:

git clone https://github.com/cubing/icons && cd icons
make

Files are build into the ./dist dir.

Using nix for development (optional)

We provide a nix shell that you can activate with: nix develop

Upgrading/changing dependencies

package-lock.json is the source of truth. Use npm to change dependencies (if all you're doing is installing dependencies, you don't need npm).

As soon as nix gets support for bun lockfiles, we can remove this quirk.

Releasing

To bump the version and deploy to npmjs.org:

npm version [major|minor|patch] -m "Release description"
git push --follow-tags
make publish