██████╗ ██████╗ █████╗ ██████╗████████╗██╗ ██████╗ █████╗ ██╗ ██╗ ██╗
██╔══██╗██╔══██╗██╔══██╗██╔════╝╚══██╔══╝██║██╔════╝██╔══██╗██║ ██║ ██║
██████╔╝██████╔╝███████║██║ ██║ ██║██║ ███████║██║ ██║ ██║
██╔═══╝ ██╔══██╗██╔══██║██║ ██║ ██║██║ ██╔══██║██║ ██║ ██║
██║ ██║ ██║██║ ██║╚██████╗ ██║ ██║╚██████╗██║ ██║███████╗███████╗██║
╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚══════╝╚══════╝╚═╝
NOTE: Ascii Art Generator: https://patorjk.com/software/taag/#p=display&f=ANSI%20Shadow&t=Practicalli%205
A guide to software development with the ClojureScript programming language, using Clojure CLI and a wide range of community tools for a REPL focused workflow.
The guide uses Practicalli Clojure CLI Config to provide aliases to run over 30 community tools that complement the workflow, including a REPL Reloaded workflow for a highly interactive and effective development experience.
Learn how to develop simple client-side web applications using the ClojureScript programming language, a functional programming language compiled to JavaScript.
ClojureScipt can be used for simple landing pages with CSS frameworks, Single Page Apps following a react.js approach or complex user interfaces with effective state management.
Figwheel-main is a build tool which provides a highly interactive development workflow, providing instant feedback on code changes. Figwheel also provides a test runner for continuous unit testing during development.
Reagent, a react-style library, is used for single page applications. Hiccup and Selma are used for managing content.
Learning ClojureScript syntax and how to think in a functional design is also covered with code examples and challenge that help embed these concepts.
This work is licensed under a Creative Commons Attribution 4.0 ShareAlike License (including images & stylesheets).
Issues and pull requests are most welcome although it is the maintainers discression as to if they are applicable. Please detail issues as much as you can. Pull requests are simpler to work with when they are specific to a page or at most a section. The smaller the change the quicker it is to review and merge.
Please read the detailed Practicalli contributing page before raising an issue or pull request to avoid disappointment.
Practicalli Clojure CLI Config provides a user level configuration providing aliases for community tools used throughout this guide. Issues and pull requests can also be made via its GitHub repository.
By submitting content ideas and corrections you are agreeing they can be used in this workshop under the Creative Commons Attribution ShareAlike 4.0 International license. Attribution will be detailed via GitHub contributors.
All sponsorship funds are used to support the continued development of Practicalli series of books and videos, although most work is done at personal cost and time.
Thanks to Cognitect, Nubank and a wide range of other sponsors for your continued support
The megalinter GitHub actions will run when a pull request is created,checking basic markdown syntax.
A review of the change will be carried out by the Practicalli team and the PR merged if the change is acceptable.
The Publish Book GitHub action will run when PR's are merged into main (or the Practicalli team pushes changes to the default branch).
Publish book workflow installs Material for MkDocs version 9
Zensical can be installed locally via vu or pip. Practicalli uses uv and installs Zensical as a tool for simplicity.
CLI Commands are wrapped in tasks defined within the Makefile, providing a simpler and consistent user experience.
Zensical - Practcialli Engineering Playbook
Clone the repository and change into the root of the project.
git clone https://github.com/practicalli/clojurescriptInstall Zensical as a tool using uv (updating if there is a new version).
make docs-installOr use the uv command:
uv tool install zensical --with catppuccin-zensical --upgradeBuild the website and serve locally at http://localhost:8000
make docsOr use the zensical command:
zensical serve --dev-addr localhost:7777Specific command if now using make:
Create a virtual python in the root of the project.
uv tool install zensical --upgrade