Raxx.Kit

Raxx.Kit is a project generator for creating boilerplate code for an Elixir web project and getting started with Raxx/Ace.

Get started with Raxx + Elixir

$ mix archive.install hex raxx_kit
$ mix raxx.kit my_app

Includes:

  • Isolated web layer with Raxx
  • HTTP/2 support with Ace server
  • Middleware for request logging and static content.
  • Ecto 3.0 and PostgreSQL integration
  • Controller unit tests
  • Code reloading with ExSync

Tutorial for building a distributed chatroom with Raxx.Kit

Options

  • --ecto: Adds Ecto as a dependency and configures project to use a Postgres database. If used with --docker flag, a docker-compose service with the database will get generated.

  • --node-assets: Add JavaScript compilation as part of a generated project. Works with or without docker.

  • --docker: Create Dockerfile and docker-compose.yml in template. This allows local development to be conducted completly in docker.

  • --module: Used to name the top level module used in the generated project. Without this option the module name will be generated from path option.

  $ mix raxx.kit my_app

  # Is equivalent to
  $ mix raxx.kit my_app --module MyApp
  • --no-exsync: Doesn’t include exsync in the generated project. Changed files won’t be rebuilt on the fly when the app is running.

  • --apib: Generate an API Blueprint file which is used as the project router.

Next

Contributing

NOTE: dotfiles in the priv directory are not automatically included in an archive.

Raxx.Kit source code is released under Apache License 2.0.