Development workflow

The first thing I do when I want to develop ventas, is bringing up my local environment:

$ docker-compose up

Then, I open Cursive, and start a REPL (just a regular leiningen repl, but inside Cursive).

When the REPL starts, I load the code and start the mount system:

> (init)

When I've changed backend code and I want it to be reloaded, I type this:

> (repl/r)

Clojurescript code gets reloaded on the fly thanks to Figwheel, and SASS code gets reloaded thanks to sassc and Figwheel.

CLJS gotchas

Devtools custom formatters

It is very important that you enable custom formatters in Chrome to easily debug the application.

Basically, if you don't see this in your console, something is wrong:

CLJ gotchas

Exceptions while reloading

Sometimes, your code has a syntax error, you reload it and, suddenly, it seems you can't do anything anymore:

(repl/r)
:reloading (repl user ventas.server.api ventas.server.api.admin ventas.server.api.user ventas.server.api.description ventas.plugins.featured-categories.core ventas.plugins.slider.core ventas.plugins.blog.core ventas.plugins.featured-products.core ventas.core ventas.database-test)
:error-while-loading repl
             java.lang.RuntimeException: Unable to resolve symbol: doesnotexist
(repl/r)
             java.lang.RuntimeException: No such var: repl/r
clojure.lang.Compiler$CompilerException: java.lang.RuntimeException: No such var: repl/r, compiling:(/tmp/form-init1507582247396403063.clj:1:1)

The solution to this is moving to the REPL namespace and executing the refresh function:

(in-ns 'repl)
(tn/refresh)
;; alternatively...
(clojure.tools.namespace.repl/refresh)

You can keep reloading this way until you solve the error.

If the problem is too, well, problematic, you can try tn/refresh-all.

Database changes

Sometimes you'll add an entity type, or add a fixture, and you'll want to update the database.

In the case of the entity type:

(ventas.database.schema/migrate)

In the case of the fixture, you can transact it directly:

(db/transact [{:schema/type :schema.type/something
               :something/stuff true}])

But the proper way is this (especially if your entity type uses the *-seed lifecycle functions):

(ventas.database.seed/seed-type :something)

SASS

This project roughly follows BEM.

To add a new file, you need to add it to scss/main.scss.