Clojurians Log v2

In Fulcro RAD, is there an easy way to display in a form a string in a multiple line textbox / text area? Here’s how it currently appears in a form, and you can see what it looks like in the report (multiple paragraphs). Thank you!

For those of you interested in trying out Fulcro RAD, here’s a checklist I’m starting to build so I can create resolvers, reports and forms more quickly. The first time around took nearly 14 hours, with much help needed from @holyjak and @tony.kay (which you may have witnessed. 🙂 I managed to write an entirely new set of resolvers, a report and form in about two hours today. 🎉🎉🎉. This time around, it’s definitely feeling like the best of Ruby on Rails, where you can build a surprisingly large amount of stuff w/surprisingly little effort. Here’s that cookbook in a Google Doc — feel free to comment. I’ll clean up the doc, and keep recording what mistakes I make. https://docs.google.com/document/d/1tp3-Fgo0GRTnh11KPr7O-k15g8DiRekqGUDA6WtQqyk/edit# (I’ll make it publicly readable, and public can comment)

I seem to remember making a :textarea style…look in semantic-ui-controls, it has the map from styles to controls that are pre-installed…or add your own.

Very cool — will look!!! Thx!!!

How does Fulcro do with queuing and retrying for when applications are offline? Also, Is there any support for cache persistence into something like LocalStorage or AsyncStorage?

Fulcro 3 has some additions along these lines. See tenacious remote

(and the network of destiny 😉 )

has to be idempotent mutation, and you don’t get reads of the written result until back online. Doing more is a harder task

I’ve seen the term “chrome” used to describe a top element in a component graph. Where does this originally come from? As an example, the template has TopChome defsc https://github.com/fulcrologic/fulcro-template/blob/master/src/main/app/ui/root.cljs#L198

https://en.wikipedia.org/wiki/Graphical_user_interface#User_interface_and_interaction_design (2012) > The visible graphical interface features of an application are sometimes referred to as chrome or GUI and from the referred https://www.nngroup.com/articles/browser-and-gui-chrome/ > Chrome is the visual design elements that give users information about or commands to operate on the screen's content (as opposed to being part of that content). These design elements are provided by the underlying system — whether it be an operating system, a website, or an application — and surround the user's data. > ... > I don't know who came up with the term "chrome," but it was likely a visual analogy with the use of metal chrome on big American cars during the 1950s

Plus one on the car analogy

Hi @tony.kay! Is it so that reports to not run (= fetch & show their data) if they are displayed as the default route of a router, i.e. (in URL terms) when I go to /myrouter instead of /myrouter/report-target-1 ? I believe you mentioned something about some UISM events not being triggered for default routes, causing this. Is this intentional or a bug? If it is intentional - what is the recommended solution to avoid the problem? My use case is that I have nested routers like this:

Root Router
 |- OrgList report
 \- OrgDetails component - ExtraInfoRouter -- Extra1 report
                                           |- Extra2 report
                                           \- Extra3 report

It is intentional. The first frame is a render of initial state…remember in Fulcro V === F(state)

so, you need to start the routers… the dr/initialize will start all routers that can be found in the current query…however, it is still a good idea to do a route-to to the “default route” on startup to ensure the proper events have been sent to the proper router(s)

The init function in RAD demo client is pretty much what I’d suggest for most apps:

(defn init []
  (log/merge-config! {:output-fn prefix-output-fn
                      :appenders {:console (console-appender)}})
  (log/info "Starting App")
  ;; default time zone (should be changed at login for given user)
  (datetime/set-timezone! "America/Los_Angeles")
  ;; Avoid startup async timing issues by pre-initializing things before mount
  (app/set-root! app Root {:initialize-state? true})
  (dr/initialize! app)
  (setup-RAD app)
  (dr/change-route! app ["landing-page"])
  (history/install-route-history! app (html5-history))
  (auth/start! app [LoginForm] {:after-session-check `fix-route})
  (app/mount! app Root "app" {:initialize-state? false}))

doing the set-root! before mount allows you to do most API calls “headless”

(that does not guarantee they are complete by mount, so you still need to be careful there), but it should at least ensure you’ve got your initial state in good shape. The fix-route mutation 2nd to last there is doing 2 things: Asking the auth state machine to check if you already have a session, and afterwards run the mutation `fix-route, which can change the route to what the user originally pasted into the URL. I didn’t add it to the demo, but having a top-level :ui/ready? flag that defaults to false is a nice add. Show an app loading animation while that is false, and then have the final fix-route (which will be in the tx queue in order) turn “on” the UI is a good touch for production

(i.e. ensuring your app has stabilized before showing the first frame)

^^^ Please feel free to send a PR on developer guide with this info if you see a good spot for it….I don’t have time to edit that into good shape, but it’s good info

Thank you very much! OK, so the default route does not get the report init event (whatever it is called in practice) triggered because you want to be able to render the "first frame" when we assume that the whole system does not need to be ready yet. So best practice is to always route to a concrete target and leave the "fallback to the first target default" only for the initial frame render, correct? In my case that means that OrgList needs to know not simply its sibling target, the OrgDetails , but it must know the leaf target in its substree, i.e. Extra1 and that coupling is unavoidable. Correct? (And yes, I will think about how to best add the info to the Guide once I fully understand it.)

hello, trying to use a RAD form here, it works for most fields, but when I add a field that's an :enum, the whole form stops rendering, and there is no error message, where is the next place to try to find the problem?

I'm working on a multi-tenant Saas application, where each tenant company has a separate SQL database, and there are potentially thousands of tenants. Are Fulcro and Pathom suitable for this scenario?

I'd believe so. Simply switch the data source in pathom's env for each request based on tenant ID using a pathom env middleware

No idea. Enum of what type? Is there an input control for that type? But normally RAD would warn if it was missing a control...

You could define a custom (possibly dummy) control for the field to discover whether that is the problem. Or/and wrap the default with react error boundary...

Thanks for the very quick reply!

See https://github.com/fulcrologic/fulcro-rad-semantic-ui/blob/develop/src/main/com/fulcrologic/rad/rendering/semantic_ui/semantic_ui_controls.cljc#L37

Turns out ao/enumerated-labels just needs to be a map of enum -> str, and it can't be a fn.

Not sure yet why fulcro rad eats that error though. I would expect something in the log

Oh, I am re-reading https://book.fulcrologic.com/#_partial_routes : > We only trigger routing events on the *specific routers and targets that are included in the destination path > [..] however, it also means that it is easy for you to confuse yourself by not routing to a real "leaf". so that clears my confusion about routing. I just need to find a good way to find out the "leaf".

@tony.kay I am still trying to wrap my head around partial routes. The book states that the user should always route explicitly to a leaf target, explaining that it is e.g. to avoid any unexpected, not-asked-for I/O along the path. So far so good. understand that until you explicitly route to a router, it is in the "unrouted" state. So why do we have the concept of a default target, as mentioned in defrouter docstring? When/why is it used? Why not simply display the body of the router until explicitly routed to a particular child target? If I understand it correctly, if I change-route! with a partial route, the target router will display its first target but no routing events will be triggered for the target (or any nested routers underneath) so it will be in a kind of a weird state, no? Question 2: It seems to me to create unnecessary coupling when the User[n] target from 17.1. Routers needs to know not only about its sibling Settingsbut also about all its nested routers so that it can correctly route to [settings "pane1"] when it in fact does not care about the content of Settings and would prefer for Settings to handle its nested routers itself. If I refactor Settings - adding a new router level or removing Pane1 - I have to remember to update all places that route to Settings accordingly. It could be solved if there was a "hook" where settings could trigger (change-route-relative! this this ["pane1"]) if the incoming route does not specify any of its children. But is there such a place? Or is the idea worse then coupling User to the internals of Settings?

@holyjak close: 1. You route to targets which are children of routers 2. If you don’t mention a target in your path, then the router that controls that target will not get called, and yes, it will be in an unrouted state 3. The “default route” is about initial fulcro app state. It won’t even render anything at all unless that is set up…and the initial state a router returns is the intial state of all sub-targets, but the “current” route initial state will be set to the first of the targets…BUT that does not start the state machine, so the router technically does not know anything, and since routers are composable, they cannot assume they are even on screeen. Thus the need for you to tell the system when started what route you want.

The “current route” of an application is global knowledge that you have to control…it typically comes from the URL, and isn’t even fully under your control (user could press back). Don’t confuse that fact with the needs of “general composition” in code.

Right, excuse my inexact terminology, I will try to be more rigorous next time.

In terms of relative routes: You simply have to know the destination from anywhere you issue a new route…In terms of making a “default place to go if unspecified”…well, I have not written that feature

I guess you could make Settings a target instead of a router

Thank you! So the only raison d'etre of the default target is so that the app can get a meaningful state. That makes sense.

and then nest another router within it, so then on enter Settings could optionally issue a relative change route if it felt the need

you’ve got it, yes

> on enter Settings could optionally issue a relative change route where would that be?

Also note the new stuff where you can route to a target by class name, that is super handy. I never use strings anymore

:will-enter route deferred

I don’t remember if there’s any restriction on a router also being a target…I cannot think of one.. It might not work…I don’t remember if the route scanning logic would like that. I think they have to be separate for the moment (routers cannot be targets), but it probably would not be hard to remove such a restriction

ok, so I can route from inside that one, great to know! Thank you so muc!

yeah, asking to route just issues a new transaction on the queue, which will run “later”

up to you to prevent infinite txn loops 🙂

I just remember that you told them that triggering change-route! inside defrouter 's body (when state is neither :pending nor :failed => not routed yet) is bad and confuses the system.

(I am done with the flood of PRs now. But they are mostly super tiny so I hope it is not too much of a bother 🙏 .)

yes , that is a good question.

I must remember to re-read the Fulcro Developer Guide regularly, it is getting better constantly :-)