Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Tilex - Today I Learned in Elixir


Today I Learned is an open-source project by the team at Hashrocket that catalogues the sharing & accumulation of knowledge as it happens day-to-day. Posts have a 200-word limit, and posting is open to any Rocketeer as well as select friends of the team. We hope you enjoy learning along with us.

This site was open-sourced in as a window into our development process, as well as to allow people to experiment with the site on their own and contribute to the project.

We originally implemented Tilex as hr-til, a Ruby on Rails app.

For updates, follow us on Twitter and subscribe to our monthly newsletter.


If you are creating your own version of the site, fork the repository and clone your fork:

$ git clone<your_github>/tilex
$ cd tilex

Then, install Erlang, Elixir, Node, and PostgreSQL. asdf can do this in a single command:

$ asdf install

From here, we recommend using make:

$ make
$ make setup server

To do everything by hand, source your environment variables, install dependencies, and start the server:

$ cp .env{.example,}
$ source .env
$ mix deps.get
$ mix ecto.setup
$ npm install --prefix assets
$ mix phx.server

Want to start with an empty database? Skip the seeds by running mix ecto.create && mix ecto.migrate in place of mix ecto.setup.

Now you can visit http://localhost:4000 from your browser.

To serve the application at a different port, include the PORT environment variable when starting the server:

$ PORT=4444 mix phx.server


Authentication is managed by Ueberauth and Google. See the ueberauth_google README and Google Oauth 2 docs for instructions. To allow users from a domain and/or comma-separated allowlist, set those configurations in your environment:

# .env

export GOOGLE_CLIENT_SECRET="yoursecret"

Once set, visit http://localhost:4000/admin and log in with an email address from your permitted domain.

Tilex creates a new user on the first authentication, and then finds that same user on subsequent authentications.


Wallaby relies on ChromeDriver; install it via your method of choice. Then, run tests with:

$ make test


$ mix test


Hashrocket's Tilex is deployed to Heroku. These are Hashrocket's deployed instances:

This project contains Mix tasks to deploy our instances; use as follows:

$ mix deploy <environment>


Please see CONTRIBUTING for more information. Thank you to all of our contributors.

Code of Conduct

This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct. Please see CODE OF CONDUCT for more information.


We love seeing forks of Today I Learned in production! Please consult USAGE for guidelines on appropriate styling and attribution.


Tilex is released under the MIT Please see LICENSE for more information.


Hashrocket logo

Tilex is supported by the team at Hashrocket, a multidisciplinary design and development consultancy If you'd like to work with us or join our team, don't hesitate to get in touch.