Openship is an operations platform that enables multi-channel fulfillment
To get Openship running on your local machine:
git clone https://github.com/openshiporg/openship
//.env
FRONTEND_URL=http://localhost:3000
DATABASE_URL=postgresql://postgres:example@url:3000/postgres
SESSION_SECRET=please_change_meBe sure to replace DATABASE_URL with a postgres connection string.
You can run postgres locally or get a database online.
Railway offers a free, temporary postgres database.
Run the following commands start up Openship:
$ cd openship
$ yarn install
$ yarn devOpenship: http://localhost:3000
Once the application is running, go to localhost:3000. If there are no users in the database, you'll be redirected to localhost:3000/init where you can create the admin user.
GraphQL Playground: http://localhost:3000/api/graphql
Use the playground to build and run queries/mutations against the API.
Keystone CMS: http://localhost:8000
Openship uses Keystone.js. Running Openship locally will give you access to the Keystone CMS at localhost:8000. It's a great way to see and interact with your database.
Openship uses Next.js, so naturally, it can be hosted anywhere that supports Node.js. Openship also requires a postgres database.
These deployment services offer Node.js and postgres databases so Openship can be deployed in 1-click.
To deploy on platforms that don't support databases like Netlify and Vercel, you'll need to pass a postgres connection string as the DATABASE_URL variable.
Go to site settings > build & deploy > environment and add these variables:
FRONTEND_URL=http://localhost:3000
DATABASE_URL=postgresql://postgres:example@url:3000/postgres
SESSION_SECRET=please_change_meReplace DATABASE_URL with a postgres database connection string and FRONTEND_URL with the url ending in netlify.app. Redeploy the site.
Openship wouldn't be here without these great projects