seripap / linear-sync

Easily synchronize issues between Linear and GitHub

LinearSync

Syncs GitHub issues and comments with linear.app

Development

Environment requirements:

• Elixir
• Postgres
• ngrok

---

Start local postgres service

$ docker-compose up

Setting up the application:

• Start an ngrok session: ngrok http 4000
• Copy config/dev.secret.template.exs to config/dev.secret.exs
• Configure ngrok_host in config/dev.secret.exs
• Configure Linear.Repo in config/dev.secret.exs
• Configure Linear.Auth.Github in config/dev.secret.exs (see: Creating a GitHub App) with repo scope
• Setup the project with mix setup
• Start Phoenix endpoint with iex -S mix phx.server

Now you can visit the URL provided by ngrok from your browser to access the application.

Why use ngrok?

Webhook requests from GitHub or Linear cannot target localhost, so while in development we use ngrok to expose the application to the internet. Phoenix uses this URL when configuring webhooks, therefore allowing the application to receive webhook requests while still running locally.

Learn more

• Official website: https://www.phoenixframework.org/
• Guides: https://hexdocs.pm/phoenix/overview.html
• Docs: https://hexdocs.pm/phoenix
• Forum: https://elixirforum.com/c/phoenix-forum
• Source: https://github.com/phoenixframework/phoenix