Exist Integrations

Laravel application that connects disparate data sources with Exist.io.

As of 2024-APR-20, Exist Integrations will cease to function. There are some logical errors based on the various APIs and I've had no time to work on it. It's unfortunate that I couldn't get a longer runway or alternative scripts to run, but for my situation I needed to get this off my plate. The repository is archived and read-only so you can use it for the basis of your own integrations to Exist.

.env setup

To connect to the various services that use OAuth 2.0, you will need to add the following parameters to support the Client ID and Client Secret.

BASE_DAYS=14
LOG_DAYS_KEPT=21

MESSAGE_CONTENT=""

EXIST_CLIENT_ID=""
EXIST_CLIENT_SECRET=""

TRAKT_CLIENT_ID=""
TRAKT_CLIENT_SECRET=""

YNAB_CLIENT_ID=""
YNAB_CLIENT_SECRET=""

WHATPULSE_HOUR = 10
TRAKT_HOUR = 20
YNAB_HOUR = 30
TOGGL_HOUR = 40

Base Days and Log Days Kept

The BASE_DAYS is how many days will be processed for each user when the Processors run.

The LOG_DAYS_KEPT is how many days the user_data logs will be kept. It must be greater than the BASE_DAYS due to weird timezone processing.

Global Message

If you want to display a message to the end users you can set the MESSAGE_CONTENT environment variable. It will display on the logged in page.

UI Elements

Exist Integrations uses Tailwind for its CSS.

Button usage should follow the examples on the Buttons with the following rules:

Execute an action (Update/Insert) - Colors Success

inline-block px-6 py-2.5 bg-green-500 text-white font-medium text-xs leading-tight uppercase rounded shadow-md hover:bg-green-600 hover:shadow-lg focus:bg-green-600 focus:shadow-lg focus:outline-none focus:ring-0 active:bg-green-700 active:shadow-lg transition duration-150 ease-in-out

Link to Manage an activity - Colors Primary

inline-block px-6 py-2.5 bg-blue-600 text-white font-medium text-xs leading-tight uppercase rounded shadow-md hover:bg-blue-700 hover:shadow-lg focus:bg-blue-700 focus:shadow-lg focus:outline-none focus:ring-0 active:bg-blue-800 active:shadow-lg transition duration-150 ease-in-out

Link to Manage an activity (secondary action) - Outline Primary

inline-block px-6 py-2 border-2 border-blue-600 text-blue-600 font-medium text-xs leading-tight uppercase rounded hover:bg-black hover:bg-opacity-5 focus:outline-none focus:ring-0 transition duration-150 ease-in-out

Delete something - Colors Danger

inline-block px-6 py-2.5 bg-red-600 text-white font-medium text-xs leading-tight uppercase rounded shadow-md hover:bg-red-700 hover:shadow-lg focus:bg-red-700 focus:shadow-lg focus:outline-none focus:ring-0 active:bg-red-800 active:shadow-lg transition duration-150 ease-in-out

Correct data - Colors Warning

inline-block px-6 py-2.5 bg-yellow-500 text-white font-medium text-xs leading-tight uppercase rounded shadow-md hover:bg-yellow-600 hover:shadow-lg focus:bg-yellow-600 focus:shadow-lg focus:outline-none focus:ring-0 active:bg-yellow-700 active:shadow-lg transition duration-150 ease-in-out

The UI framework uses vite. Any usage of new CSS elements needs to be built into the Assets folder. Execute the command:

npm run build