🔔 You should only need to run the UI development server if you're contributing to the UI. If you just want to run the UI to see your Unison codebase, it should either come pre-installed with ucm or if you built from source can be downloaded with a script: ./dev-ui-install.hs from the unison repository (Running Unison).

1. Start ucm (the executable is unison instead of ucm if you built the unison repository from source) in headless mode: ucm headless, and copy the API URL (this URL is uniquely generated by ucm at start-up) from the ucm start-up output (ucm also outputs a UI URL, but this isn't used when developing for the UI/running the UI from this repository).

2. Make sure the latest dependencies are installed with by running npm install

3. Start the Unison Share dev server with: API_URL="<API URL FROM UCM>" npm run start:unisonShare or the Unison Local dev server with: API_URL="<API URL FROM UCM>" npm run start:unisonLocal

4. Visit http://localhost:1234 in a browser.

To add new icons, copy the SVG markup to a new function in /src/UI/Icon.elm following the convention seen there of other icons. The color (fill or stroke) of the shape must be currentColor.

Code of conduct