Carbon

User library for phoenix and elixir.

Carbon

Installation

Carbon is available in Hex, and can be installed as:

Add carbon to your list of dependencies in mix.exs:
def deps do
```
 [{:carbon, "~> 0.1.3"}]
```
end
Ensure carbon is started before your application:
def application do
```
 [applications: [:carbon]]
```
end

Usage

To install carbon in your application

  mix carbon.install

Above command generates a migration, that is all you need to install Carbon, you can modify the migration to add your custom fields, Carbon only requires following fields

  * email
  * password_hash

To install and migrate database use –migrate switch

  mix carbon.install --migrate

configure Carbon

  config :carbon, 
    repo: MyApp.Repo

Setup a mailer to send out emails, Carbon uses swoosh email library to send out emails, please visit (Swoosh)[https://github.com/swoosh/swoosh] for more details

  config :carbon, Carbon.Mailer,
    adapter: Swoosh.Adapters.Logger,
    level: :debug

  use Carbon.Routes

Carbon registers few routes, and can be overridden

  /login
  /logout
  /register
  /password/reset

Roadmap

We are using carbon in production already, we have plans for Carbon some of the stuff in pipeline:

* generators for migration, controllers, views, models, mailers
* mailers for welcome,signup,reset emails
* oauth integration
* multiple adapter support session,jwt and more
* and perhaps memberships out of the box

Contributing

Contributions are welcome! We love you if you send a PR with some tests.

License

Apache 2 License.