The Mulberry Symbols are collection of pictograms / symbols / icons designed for AAC users who rely on graphics symbols for communication with others. They include more unusual symbols, including many suitable for adult AAC users. The symbols are freely usable, sharable and modifiable having a liberal Creative Commons license. Thus they are perfect for using in on-line applications as there are no license fees to consider.
The symbols are provided in Scalable Vector Format (SVG) so they look good at any size. We've always preferred this format and it is now readily usable on the web and other platforms. If you want a fixed size raster image there are various SVG tools that allow you to convert to the resolution that you require.
See mulberrysymbols.org for more details
This is a typical npm/node managed package. A source of complexity, especially in releases, is due to the symbols and the website being in the same repo.
Several npm scripts are provided in
- test - checks the symbols names against the
- build - build everything
- build:zip - generates the .zip for distribution
- build:categories - generate categories-xx.pdf and catagories-en.html
NB building the HTML require puppeteer which currently does not work on WSL on Win 10 (it might on Win 11).
If you want to develop the website locally follow the instructions on Githubs docs
Currently this is a manual process. The following updates the zip and category files ready for the release
- Update the version number in
- Commit and push everything so merged to master on GitHub
npm run buildto build the zip and categories files
- Make a GitHub Release with Tag of
v<RELEASE NUMBER>, adding release notes
- Add the zip to the release
categories-xx.pdfto the release
categories-en.htmlto the release
symbol-info.csvto the release - this gets generated manually from a master Google Sheet
- Announce the release
git pullto get the release tag locally
Updating the website assets
The website references files in the latest release so this may need to be built first.
The website files are found in the
docs folder and the
README becomes the home page.
Any changes pushed to
master cause the website to be regenerated and published.
Thanks to the following people for helping to improve the Mulberry Symbols