Boyscout is a Clojurescript rewrite of Clement Mihailescu's Pathfinding Visualizer. All credit's for the idea and sexy animations sould go to him 🎓. Boyscout can visualize a couple of famous pathfinding algorithms for fun and educational purpouses.
View Boyscout in action on: https://yannvanhalewyn.github.io/boyscout/ and after playing around a bit click on the Boyscout logo in the header for a hidden feature 😉.
This project has been built to practice algorithms, demonstrate the power of a declarative functional approach and most importantly to have some fun.
Some nice technical features to check out:
- A board model as a weighted bigraph
- An algorithm abastraction, think adapter pattern but not really. It's just some functions.
- A simple animation system built with core.async that can be stopped, rewinded and is open for more features (stepping feature? 🤔)
- Using clojure meta-data to link straight to source in the UI
Clone the repo and the first time run:
$ yarn install
$ make css
Then to start and watch the test and dev build and start a nRepl server:
$ make dev
And visit localhost:8080 to see the app, and localhost:8081 to se the test runner.
Note: you won't see a repl appear with this command. A nRepl server was started and you should connect to it with your favorite editor. If that's not an option you can run make repl to have a terminal repl. This won't build the test app though.
To watch the changes in css run:
$ make css-watch
To build the project with all optimisations run:
$ make build
And open the index.html file in the root of the project.