Raxx.Kit

Get started with Raxx + Elixir

Includes:

  • Isolated web layer with Raxx
  • HTTP/2 support with Ace server
  • API documentation with API Blueprint, use --apib.
  • Middleware for request logging and static content.
  • Controller unit tests
  • Code reloading with ExSync

Installation

$ mix archive.install https://github.com/CrowdHailer/raxx_kit/raw/master/raxx_kit.ez

Create a project

$ mix raxx.kit my_app

See options to customise.

Start project

$ cd my_app
$ iex -S mix

By default, the new project will accept http connections on port 8080 and https connections on port 8443. Visiting http://localhost:8080 should show the homepage. Visiting https://localhost:8443 will use HTTP/2 but you will need to accept the self signed certificate or generate a new one.

Next

Options

  • --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
  • --apib: Generate an API Blueprint file which is used as the project router.

Contributing

Building a new archive

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

mix archive.build --include-dot-files -o raxx_kit.ez

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