Phoenix/Mix template for projects at Nimble.
NimbleTemplate has been developed and actively tested with the below environment:
- Mix 1.13.3
- Elixir 1.13.3
- Erlang/OTP 24.2.2
- Phoenix 1.6.11
- Node 16.15.0
Note: NimbleTemplate only works on a new Phoenix/Mix project, applying it to an existing Phoenix/Mix project might not work as expected.
Step 1: Generate a new project
# New Phoenix project
mix phx.new awesome_project
# New Mix project
mix new awesome_project
Step 2: Add nimble_template
dependency to mix.exs
:
def deps do
[
{:nimble_template, "~> 4.3.0", only: :dev, runtime: false},
# other dependencies ...
]
end
Step 3: Fetch and install dependencies
Run this command in the root of the project directory to install NimbleTemplate.
mix do deps.get, deps.compile
mix help nimble_template.gen # Print help
mix nimble_template.gen -v # Print the version
# Phoenix application
mix nimble_template.gen --web # Apply the Web template
mix nimble_template.gen --api # Apply the API template
mix nimble_template.gen --live # Apply the LiveView template
# Non-Phoenix application
mix nimble_template.gen --mix # Apply the Mix template
The testing documentation is on Wiki
The release documentation is on Wiki
Contributions, issues, and feature requests are welcome!
Feel free to check issues page.
The Phoenix application generator is missing. By solving this problem, you need to run
mix archive.install hex phx_new
or
mix archive.install hex phx_new #{specific-version}
Your OS is missing/not installing chromedriver
, you need to run:
Homebrew
brew install --cask chromedriver
Debian/Ubuntu
apt install chromium-chromedriver
Or download the package on the official site: https://chromedriver.chromium.org/downloads
This project is Copyright (c) 2014 and onwards. It is free software, and may be redistributed under the terms specified in the LICENSE file.
This project is maintained and funded by Nimble.
We love open source and do our part in sharing our work with the community! See our other projects or hire our team to help build your product.