225e3b1c2f
Preload the user namespace (src/user.cljs and src/dev/user.cljs) for the mobile target and for dev-only purposes. The files are git-ignored. Just a reminder that you'll be responsible for making sure your user namespace is correct. If it's broken in any way (e.g. calling non-existent code) the app will crash at initialization (dev-only environment obviously). Why? When the app initializes, it loads namespaces that were required at least once. If you create a user namespace, it won't be automatically required for you. And if you, like some Clojure devs, like to use the user namespace as your safe heaven for experimentation and dev-only utilities, you'll need to remember to evaluate the namespace at least once. This is tedious and many times I forgot to do so and the app crashed because the compiler didn't know where the symbols were coming from.
The dev/ directory
The src/dev/ directory is a place where developers can commit non-production
and non-test code which can facilitate development in general. The code should,
ideally, be useful to more than one team member.
Note: As of today (2024-05-07), we don't have further guidelines or examples about how mobile teams should use and maintain these dev-only namespaces. Before opening a PR introducing new dev-only namespaces, consider sharing and discussing with as many team members as you can.
The user namespace
You may optionally create a src/dev/user.cljs and/or src/user.cljs file.
These files are git-ignored and are meant to be your own playground. Clojure
developers usually use such namespaces to create temporary utilities and
experiments that aren't necessarily useful to others. They are particularly
valuable for developers adept at the REPL-Driven Development workflow.
Be careful with make clean because it will delete all non-tracked git files.
If you rely on this file, you may prefer to create a symbolic link and store the
original user.cljs file outside the status-mobile repository. Then, after
make clean, you will need to recreate the symlink.