The Rails app with appropriate tools for quick starting developing shopify app.
How to install?
git clone https://github.com/ASoftCo/shopify-app-starter-kit.git
cd shopify-app-starter-kit
git remote set-url origin new_git_repo_url
bundle install && bundle exec rails db:create db:migrate
- Install and run Redis
- Rename the app module in the
config/application.rb
file - Install ngrok
- Create a new app in your shopify partner account
- use ngrok url as a
App URL
in theApp setup
section - add
whitelisted redirection URL(s)
:
http://<your_ngrok_host>/auth/shopify/callback
https://<your_ngrok_host>/auth/shopify/callback
rails credentials:edit
and add all settings fromconfig/credentials_sample.yml
- Change all credential values in your
config/credentials.yml.enc
file to appropriate ones.
- change
api_key
andsecret
(can be found at theApp setup
section) - change
host
setting to your ngrok url - add necessary shopify scopes
- add necessary shopify webhooks
- Add necessary workers to the
app/jobs/
directory (e.g. if you addorders/create
webhook, you should createorders_create_job.rb
worker) - For UI and CSS styles read about Polaris or Uptown CSS
Monitoring
There are several monitoring tools: New Relic, Sentry and Mixpanel.
All that you need to do is to change the values of appropriate keys (new_relic_license_key
, sentry_dsn
, mix_panel_token
) for your environment in the config/credentials.yml.enc
file.