= Awesome Fulcro

A curated list of awesome resources for https://github.com/fulcrologic/fulcro[Fulcro] and https://github.com/fulcrologic/fulcro-rad[Fulcro RAD], the most awesome (web)app framework the Earth has ever seen.

=== Motivation

• 🎬 https://www.youtube.com/watch?v=PMbGhgVf9Do&t=628s[Why Build Solutions with Fulcro - Tom Toor] (video, 2019)
• https://blog.jakubholy.net/2020/talk-want-more-from-your-frontend-framework/[Want more from your frontend framework! Re-thinking web dev experience] - "I will compare Redux + REST with a full-stack, component-centric solution based on a graph API (think GraphQL) that I came to love."

=== Learning

==== Recommended community resources

Check out Jakub's self-paced https://github.com/holyjak/fulcro-intro-wshop[workshop Introduction to creating webapps with Fulcro] to get familiar with the concepts and the amazing tooling before deep-diving into learning the details. Then continue with the xref:tutorial-minimalist-fulcro:index.adoc[Minimalist Fulcro Tutorial] and its exercises. For more, see the xref:guide-learning-fulcro:index.adoc[Guide to learning Fulcro] and all the other https://fulcro-community.github.io/[fulcro-community resources].

==== Official and semi-official documentation

• https://book.fulcrologic.com/[Fulcro Developers Guide]
• 🎬 https://www.youtube.com/playlist?list=PLVi9lDx-4C_T7jkihlQflyqGqU4xVtsfi[Fulcro 3 tutorials (video)] indispensable! ** Alex Eeberts https://github.com/aeberts/fulcro-notes-public[Fulcro Video Notes] provide a detailed table of contents for the videos, with links to the corresponding sections
• 🎬 https://www.youtube.com/c/TonyKayNW/videos[All Tony Kay’s videos] ** 🎬 https://www.youtube.com/playlist?list=PLVi9lDx-4C_TBRiHfjnjXaK2J3BIUDPnf[Grokking Fulcro series] - The intended audience of this video series is anyone with a basic understanding of Javascript and Clojurescript that wishes to know more about how Fulcro works. I do not assume a ton of prior knowledge about Fulcro itself, yet I think even most seasoned Fulcro developers will learn something from every video. Focus: Explain the lower-level details of React and Fulcro in the context of Clojurescript. Help developers gain an understanding of the core APIs of Fulcro. Cover the approaches to designing common things in Fulcro so you can apply those patterns in your own applications. Reveal some of the superpowers of Clojurescript for people that do not know it well.
• https://book.fulcrologic.com/RAD.html[Fulcro RAD Developer’s Guide]
• https://blog.wsscode.com/pathom/v2/pathom/2.2.0/introduction.html[Pathom v2]
• 2020 podcast series on Fulcro and Pathom is also a very valuable resource, full of insights and valuable reasoning https://soundcloud.com/user-959992602/s4-e6-fulcro-with-tony-kay-part-1[S4 E6 - Fulcro with Tony Kay (Part 1)] https://soundcloud.com/user-959992602/s4-e7-fulcro-with-tony-kay-part-2[S4 E7 - Fulcro with Tony Kay (Part 2)] https://soundcloud.com/user-959992602/s4-e8-fulcro-with-tony-kay-part-3[S4 E8 - Fulcro with Tony Kay (Part 3)] https://soundcloud.com/user-959992602/s4-e9-fulcro-with-tony-kay-part-4[S4 E9 - Fulcro with Tony Kay (Part 4)] https://soundcloud.com/user-959992602/s4-e10-fulcro-rad-and-guardrails-with-tony-kay-part-5[S4 E10 - Fulcro with Tony Kay (Part 5)] https://soundcloud.com/user-959992602/s4-e15-pathom-with-wilker-lucio-part-1[S4 E15 Pathom with Wilker Lúcio (Part 1)] ** https://soundcloud.com/user-959992602/s4-e16-pathom-with-wilker-lucio-part-2[S4 E16 Pathom with Wilker Lúcio (Part 2)]

==== Tutorials

• https://awkay.github.io/om-tutorial/#!/om_tutorial.D_Queries - this older OMNext / Eql tutorial is reportedly useful for understanding query syntax
• Chris O’Donnell’s Gift list dev diary series (2020) - building a non-trivial Fulcro app from scratch, step by step [arabic] . https://chrisodonnell.dev/posts/giftlist/intro/[introduction] . https://chrisodonnell.dev/posts/giftlist/authentication/[authentication] . https://chrisodonnell.dev/posts/giftlist/routing/[routing] . https://chrisodonnell.dev/posts/giftlist/initial_backend/[initial backend] . https://chrisodonnell.dev/posts/giftlist/backend_persistence/[backend persistence] . https://chrisodonnell.dev/posts/giftlist/parser_tests/[parser tests] . https://chrisodonnell.dev/posts/giftlist/api_auth/[API auth] . https://chrisodonnell.dev/posts/giftlist/gift_list_form/[form and listing] . https://chrisodonnell.dev/posts/giftlist/gift_list_navigation/[navigation] . https://chrisodonnell.dev/posts/giftlist/deployment/[deployment]
• https://folcon.github.io/post/fulcro-basics/2020-05-12-Fulcro-via-re-frame/[Fulcro via Re-frame] — makes a couple of comparisons to re-frame and proceeds to the Fulcro basics: defsc, queries, idents, normalization, mutations, and targeting.

==== Snippets and demos

• Jean Boudet, 2022: Demonstration of https://gist.github.com/jeans11/5a7ea1541401b412db7de868ef4e1851[integrating a Fulcro app into React Native] without Expo, leveraging the native-or-web library https://github.com/necolas/react-native-web[react-native-web]. Featuring Fulcro's multiple-roots-renderer and React Native's https://reactnative.dev/docs/appregistry[AppRegistry.registerComponent].

==== Troubleshooting

• https://blog.jakubholy.net/2020/troubleshooting-fulcro/[Fulcro Troubleshooting Decision Tree] - A decision tree to help you go from a problem to the most appropriate troubleshooting steps
• 🎬 https://www.youtube.com/playlist?list=PLYvJiiE4TAijBAvO-R0PO8plSto4wtoQu[Learning Fulcro - troubleshooting demos] (by Jakub Holý) - a series of short screencasts demonstrating how to troubleshoot various problems in a Fulcro app

==== Other

• https://github.com/souenzzo/eql-style-guide[EQL Style Guide] - Some tips about how to model, name, and organize your domain and your data.
• https://blog.jakubholy.net/2020/fulcro-divergent-ui-data/[Fulcro Explained: When UI Components and Data Entities Diverge] - "Fulcro’s stateful components serve normally both as elements of the UI and to define the data model, i.e. data entities with their unique IDs and attributes. But what if your UI and data model needs diverge? We will take a look at what different kinds of divergence between the UI and data entities you might encounter and how to solve them."
• https://blog.jakubholy.net/2020/error-handling-in-fulcro/[Error handling in Fulcro: 3 approaches]
• 🎬 https://roamresearch.com/#/app/bristol-clojure/page/KT5i16d-v[Fulcro notes on Tony Kay video series]
• An https://github.com/holyjak/minimalist-fulcro-template-backendless/tree/experiment/data-modeling-task-app[example of data and UI modeling] - from a graphical sketch of a UI through the analysis to a draft UI, with the thinking process documented
• 🎬 https://www.youtube.com/playlist?list=PL4aJznIeHN6xSZTcbibLEOSF5kQt9dt1S[Clojure Pairing on Fulcro with Tony Kay and Jakub Holy (2021-2023)] - annotated recordings of programming sessions Gene Kim had with Tony Kay and Jakub Holy, mostly center around RAD. Lot of excellent stuff here

==== Templates and Examples

Templates

• The official https://github.com/fulcrologic/fulcro-template[fulcro-template] and https://github.com/holyjak/fulcro-rad-demo[fulcro-rad-demo]
• https://github.com/dvingo/dv.fulcro-template - based on the fulcro3 template but differs in backend tech and will continue to diverge as features are added to this template.
• https://github.com/holyjak/minimalist-fulcro-template-backendless[minimalist-fulcro-template-backendless] - A template for starting a new, frontend-only Fulcro application with in-browser Pathom. Intended for playing with and learning Fulcro, not for production apps, and therefore simpler than the official fulcro-template.
• https://github.com/holyjak/minimalist-fulcro-template[minimalist-fulcro-template] - similar to the one above, but with an actual backend

Examples / experiments

• https://github.com/fulcrologic/fulcro/tree/develop/src/todomvc/fulcro_todomvc[Fulcro Todo MVC] - an implementation of https://todomvc.com/[todomvc.com] in Fulcro, by Tony
• https://github.com/dvingo/pathom-client-wikipedia[Dvingo’s pathom-client-wikipedia] - example client-only fulcro app hitting a rest api
• https://github.com/phronmophobic/membrane-fulcro[PoC of a GUI and a teminal UI built with Fulcro] and https://github.com/phronmophobic/membrane[Membrane]
• https://github.com/realgenekim/rss-reader-fulcro-demo[rss-reader-fulcro-demo] (2021) by Gene Kim is a RAD-based app "that lets you read past articles from the Planet Clojure RSS feed" - featuring https://github.com/realgenekim/rss-reader-fulcro-demo/blob/main/src/shared/com/example/client.cljs#L69[integrating keybord shortcuts] (via Mousetrap)

==== "Real" Apps

• https://github.com/lgessler/glam[Glam] - a https://arxiv.org/abs/cs/0010033[linguistic annotation] app that uses Fulcro, Pathom, Material-UI, and Crux. (Work in progress.)
• https://github.com/holyjak/fulcro-billing-app[fulcro-billing-app] - A somewhat simplified and anonymized fork of a production app made with Fulcro and Fulcro RAD in 2020 - 2021
• https://github.com/hhucn/decide3[Decide] (since 2019) - "Better decision-making in large groups"

=== Tools and libraries

• https://github.com/holyjak/fulcro-troubleshooting[fulcro-troubleshooting] - A development-time library for Fulcro that helps to detect problems earlier and find and fix their root cause faster
• https://github.com/matterandvoid-space/subscriptions[Subscriptions] extracts re-frame's subscriptions and generalizes them over the data store and is usable with Fulcro - here is https://github.com/matterandvoid-space/subscriptions/blob/mainline/examples/fulcro_example.cljs[demo of Subscriptions with Fulcro]
• https://github.com/RokLenarcic/fulcro-rad-indexed-db[fulcro-rad-indexed-db] - A library to use browser's https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API[IndexedDB] as a RAD storage provider