To get started, please make sure you have created a free account at https://dashboard.openship.org. Once you have an account, you can go to the settings tab and enter a whitelisted URL where your dashboard will be hosted or a tunnel URL when developing locally (e.g. ngrok).
Clone the Repo#
git clone https://github.com/openshiporg/openship
Expose Your Localhost to the Internet#
- Download ngrok
- Open terminal and navigate to where ngrok was downloaded.
- If you’re working on OSX or Linux, start ngrok with ./ngrok http 3000. If you’re on Windows, start ngrok with ngrok http 3000.
- A url ending in ngrok.io will be shown in your terminal.
- Go to https://dashboard.openship.org/settings and enter this URL in the text box and click save.
Start the Application#
Run the following commands to run it in your local machine:
$ cd openship $ yarn install $ yarn dev
Go to the ngrok.io URL from before and log into Openship using your ceredentials. Now you can customize the application and the results will be hotloaded on the ngrok.io URL. Check out the Micro Apps tutorial to build your first customization.
Since Openship is a Next.js application, deployment is very easy with now.sh. Make sure you have an account and have either the desktop application or CLI installed. Then run:
Once complete, you will have a URL ending with now.sh. Enter this URL in your settings page and replace the prodFront variable in the config.js file.
Adding shops to your own instance can be done in two ways.
- Add it directly on https://dashboard.openship.org and then you can access it on your instance
- Make a Shopify Partner account and create an app. Add a .env file to the root folder like so:
Now when you add a shop from your URL, the app you created will be installed in the shop instead of Openship.