MXquickconnect is a sample application which anyone can clone and use their MX client credentials to interface with common MX use cases using Platform API and the javascript widget. It is meant to help a developer see a sample of what MX has to offer while at the same time providing some frontend and backend code which can be extracted into any application.
Using ssh (recommended):
git clone git@github.com:mxenabled/mx-quickconnect.git
Using GibHub CLI:
gh repo clone mxenabled/mx-quickconnect
Using HTTPS:
git clone https://github.com/mxenabled/mx-quickconnect
cp .env.example .env
Create a .env file at the same level as the .env.example
.
Add your CLIENT_ID
and API_KEY
.
You can find these values in your MX Client Dashboard
There are two ways of running this app: with or without Docker. If you would like to orchestrate with Docker, skip to the Run with Docker section below.
You can choose to run one of the following backend implementations. Once started the backend will be running on http://localhost:8000
cd ruby
bundle install
./start.sh
cd mx-platform-node
npm install
npm start
cd python
pip3 install -r requirements.txt
./start.sh
Make sure you have dotnet sdk 6
or later installed.
cd mx-platform-aspnet-core
dotnet add package MX.Platform.CSharp
dotnet run
The frontend will run on http://localhost:3000 and will send api requests to http://localhost:8000.
Make sure you have npm version 7
or later installed.
cd frontend
npm install
npm start
Make sure you have docker comunity 20.10.13
and docker compose 2.3.4
or later installed.
Edit your docker-compose.yml
file:
- Remove or comment out backends you would not like to run
- Uncomment the DOCKER_PROXY_URL that corresponds to the backend you're using
- Make sure you have at least one backend, one DOCKER_PROXY_URL, and the frontend
docker-compose up
Open your browser on http://localhost:3000 and enjoy!