This app is intended as a demonstration of how to use the 29 Next App Framework in a "server to server" context.
- Oauth Setup Flow
- Session Token Login
- Remove App Settings
- Admin API access and scopes
- Webhooks setup, data validation, and
app.uinstalledevent handling.
This app uses Django, you can follow Django install guides to ensure you have Python in your local environment.
The first step is to create an App in your 29 Next Partner Account. You'll need your app Client ID and Client Secret later on in the setup process.
pip install -r requirements.txt
To access your localhost for app development, you can use Ngrok or LocalTunnel to create and open a public tunnel to your local machine.
| Variable | Description |
|---|---|
| APP_DOMAIN | Your domain when running the app (ie your public tunnel url). |
| CLIENT_ID | Your App Client ID found in your partner account. |
| CLIENT_SECRET | Your App Client Secret found in your partner account. |
To run this Django project, you'll need to set environment variables with your local app domain, app client id and client secret (from your 29 Next app).
export <VARIABLE>=<VALUE>
To run the Django app on your local, use the following command.
Django port needs to match the public tunnel port.
python manage.py runserver 0.0.0.0:<PORT>
To set up your App in the platform, you need to configure and push your app. See Example App Files
App Files
├── config.yml
├── manifest.json
└── snippets
└── checkout-message.html
With your configured manifest.json and config.yml, you can now build and push your app to your account.
nak build && nak push
You can now use App Kit to create your App Manifest to your partner account and link your development store to your app.
You can now connect your app to your development store which will initiate the Oauth setup flow and configure Admin API access. 🎉