cli | ||
config | ||
jipt | ||
lib | ||
priv | ||
rel | ||
test | ||
webapp | ||
.credo.exs | ||
.dockerignore | ||
.eslintignore | ||
.eslintrc | ||
.formatter.exs | ||
.gitignore | ||
.prettierignore | ||
.prettierrc | ||
.travis.yml | ||
app.json | ||
Aptfile | ||
CODE_OF_CONDUCT.md | ||
compile | ||
coveralls.json | ||
docker-compose.yml | ||
Dockerfile | ||
elixir_buildpack.config | ||
LICENSE.md | ||
logo.svg | ||
Makefile | ||
mix.exs | ||
mix.lock | ||
package-lock.json | ||
package.json | ||
phoenix_static_buildpack.config | ||
Procfile | ||
README.md | ||
tslint.json |
The first developer-oriented translation tool
True asynchronous flow between translators and your team.
Accent provides a powerful abstraction around the process maintaining translations in a web/native app.
- History. Full history control and actions rollback. Who did what, when.
- UI. Simple yet powerful UI to enable translator and developer to be productive.
- CLI. Command line tool to easily add Accent to your developer flow.
- Collaboration. Centralize your discussions around translations.
- GraphQL. The API that powers the UI is open and documented. It’s easy to build a plugin/cli/library around Accent.
Contents
Section | Description |
---|---|
🚧 Requirements | Dependencies required to run Accent’ stack |
🎛 Mix commands | How to execute mix task with the Twelve-Factor pattern |
🏎 Quickstart | Steps to run the project, from API to webapp, with or without Docker |
🌳 Environment variables | Required and optional env var used |
✅ Tests | How to run the extensive tests suite |
🚀 Heroku | Easy deployment setup with Heroku |
🌎 Contribute | How to contribute to this repo |
🚧 Requirements
erlang ~> 21.2
elixir ~> 1.8
postgres >= 9.4
node.js >= 8.5.0
libyaml >= 0.1.7
🎛 Executing mix commands
The app is modeled with the Twelve-Factor App architecture, all configurations are stored in the environment.
When executing mix
commands, you should always make sure that the required environment variables are present. You can source
, use nv or a custom l33t bash script.
Every following steps assume you have this kind of system.
But Accent can be run with default environment variables if you have a PostgreSQL user named postgres
listening on port 5432
on localhost
.
Example
With nv
you inject the environment keys in the context with:
$ nv .env mix <mix command>
🏎 Quickstart
This is the full development setup. To simply run the app, see the Docker instructions
- If you don’t already have it, install
nodejs
withbrew install nodejs
- If you don’t already have it, install
elixir
withbrew install elixir
- If you don’t already have it, install
libyaml
withbrew install libyaml
- If you don’t already have it, install
postgres
withbrew install postgres
or the Docker setup as described below. - Install dependencies with
make dependencies
- Create and migrate your database with
mix ecto.setup
- Start Phoenix endpoint with
mix phx.server
- Start Ember server with
npm run start --prefix webapp
That’s it!
Makefile
The Makefile should be the main entry for common tasks such as tests, linting, Docker, etc. This simplify the developpement process since you don’t have to search for which service provides which command. mix
, npm
, prettier
, docker
, stylelint
, etc are all used in the Makefile.
Docker
For the production setup, we use Docker to build an OTP release of the app. With docker-compose, you can run the image locally. Here are the steps to have a working app running locally with Docker:
When running the production env, you need to provide a valid GOOGLE_API_CLIENT_ID in the docker-compose.yml
file.
- Run
make build
to build the OTP release with Docker - Run
make dev-start-postgresql
to start an instance of Postgresql. The instance will run on port 5432 with thepostgres
user. You can change those values in thedocker-compose.yml
file. - Run
make dev-start-application
to start the app! The release hook of the release will execute migrations and seeds before starting the webserver on port 4000 (again you can change the settings indocker-compose.yml
)
That’s it! You now have a working Accent instance without installing Elixir or Node!
🌳 Environment variables
Accent provides a default value for every required environment variable. This means that with the right PostgreSQL setup, you can just run mix phx.server
.
Variable | Default | Description |
---|---|---|
MIX_ENV |
dev |
The application environment (dev , prod , or test ) |
DATABASE_URL |
postgres://localhost/accent_development |
A valid database URL |
CANONICAL_HOST |
localhost |
The host that will be used to build internal URLs |
PORT |
4000 |
A port to run the API on |
WEBAPP_PORT |
4200 |
A port to run the Webapp on (only used in dev environment) |
API_HOST |
http://localhost:4000 |
The API host |
API_WS_HOST |
ws://localhost:4000 |
The API Websocket host |
WEBAPP_URL |
http://localhost:4000 |
The Web client’s endpoint. Used in the authentication process and in the sent emails. |
Production setup
Variable | Default | Description |
---|---|---|
SENTRY_DSN |
none | The secret Sentry DSN used to collect API runtime errors |
WEBAPP_SENTRY_DSN |
none | The public Sentry DSN used to collect Webapp runtime errors |
RESTRICTED_DOMAIN |
none | If specified, only authenticated users from this domain name will be able to create new projects. |
Authentication setup
Various login providers are included in Accent using the awesomer Uberauth library to abstract services.
Variable | Default | Description |
---|---|---|
DUMMY_LOGIN_ENABLED |
none | If specified (or no other authentication configs are provided), the password-less authentication (with only the email) will be available. |
GOOGLE_API_CLIENT_ID |
none | |
GOOGLE_API_CLIENT_SECRET |
none | |
GITHUB_CLIENT_ID |
none | |
GITHUB_CLIENT_SECRET |
none | |
SLACK_CLIENT_ID |
none | |
SLACK_CLIENT_SECRET |
none | |
SLACK_TEAM_ID |
none |
Email setup
If you want to send emails, you’ll have to configure the following environment variables:
Variable | Default | Description |
---|---|---|
MAILER_FROM |
none | The email address used to send emails. |
SMTP_ADDRESS |
none | The SMTP server address you want to use to send your emails. |
SMTP_PORT |
none | The port ex: (25, 465, 587). |
SMTP_USERNAME |
none | The username for authentification. |
SMTP_PASSWORD |
none | The password for authentification. |
SMTP_API_HEADER |
none | An optional API header that will be added to sent emails. |
✅ Tests
API
Accent provides a default value for every required environment variable. This means that with the right PostgreSQL setup (and a few setup commands), you can just run mix test
.
$ npm --prefix webapp run build
$ mix run ./priv/repo/seeds.exs
$ mix test
The full check that runs in the CI environment can be executed with ./priv/scripts/ci-check.sh
.
🚀 Deploy on Heroku
An Heroku-compatible app.json
makes it easy to deploy the application on Heroku.
🌎 Contribute
Before opening a pull request, please open an issue first.
Once you’ve made your additions and the test suite passes, go ahead and open a PR!
Don’t forget to run the ./priv/scripts/ci-check.sh
script to make sure that the CI build will pass :)
Contributors
License
Accent is © 2015-2019 Mirego and may be freely distributed under the New BSD license. See the LICENSE.md
file.
About Mirego
Mirego is a team of passionate people who believe that work is a place where you can innovate and have fun. We’re a team of talented people who imagine and build beautiful Web and mobile applications. We come together to share ideas and change the world.
We also love open-source software and we try to give back to the community as much as we can.