Biff

Create a project

Requirements:

Run this command to create a new Biff project (and if you run into any problems, see Troubleshooting):

bash <(curl -s https://biffweb.com/new-project.sh)

This will create a minimal CRUD app which demonstrates most of Biff's features. Run ./task dev to start the app on localhost:8080. Whenever you save a file, Biff will:

  • Evaluate any changed Clojure files (and any files which depend on them)
  • Regenerate static HTML and CSS files
  • Run tests

You can connect your editor to nREPL port 7888. There's also a repl.clj file which you can use as a scratch space.

When you're ready to deploy, see Production.

Jacking in

cider-jack-in and similar commands will start up a JVM and an nREPL server for you. However, ./task dev already does that. Instead of running cider-jack-in, you should run cider-connect (or the equivalent) so that you can connect to the nREPL server started by ./task dev. See Connecting to a Running nREPL Server in the CIDER docs.

This does mean that CIDER will not be able to decide which version of the nREPL server dependencies to use. If you run into problems, you'll need to set the versions manually in deps.edn:

{:deps {nrepl/nrepl       {:mvn/version "..."}
        cider/cider-nrepl {:mvn/version "..."}
...
Have a question? Join the #biff channel on Clojurians Slack.