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 https://github.com/<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_ID="your-key.apps.googleusercontent.com"
export GOOGLE_CLIENT_SECRET="yoursecret"
export HOSTED_DOMAIN="your-domain.com"
export GUEST_AUTHOR_ALLOWLIST="joedeveloper@otherdomain.com, suziedeveloper@freelancer.com"
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
or:
$ mix test
Hashrocket's Tilex is deployed to Heroku. These are Hashrocket's deployed instances:
- Staging: https://tilex-staging.herokuapp.com
- Production: https://til.hashrocket.com
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.
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 License.opensource.org/licenses/MIT). Please see LICENSE for more information.
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.