🚀 Add bank account transaction integration

.env.example

@@ -46,6 +46,26 @@ EMAIL_SERVER_PORT=
 EMAIL_SERVER_USER=
 EMAIL_SERVER_PASSWORD=
 
+# GoCardless options
+GOCARDLESS_COUNTRY=
+GOCARDLESS_SECRET_ID=
+GOCARDLESS_SECRET_KEY=
+# Bank Transactions will be fetched from today and 30 days back as default.
+GOCARDLESS_INTERVAL_IN_DAYS=
+
+# Plaid options
+PLAID_CLIENT_ID=
+PLAID_SECRET=
+# sandbox/development/production
+PLAID_ENVIRONMENT=
+# https://plaid.com/docs/institutions/
+PLAID_COUNTRY_CODES=
+# Bank Transactions will be fetched from today and 30 days back as default.
+PLAID_INTERVAL_IN_DAYS=
+
+# Cron-job options
+CLEAR_BANK_CACHE_FREQUENCY=
+
 # Google Provider : https://next-auth.js.org/providers/google
 GOOGLE_CLIENT_ID=
 GOOGLE_CLIENT_SECRET=

.husky/pre-commit

@@ -1,2 +1,2 @@
 pnpm lint-staged
-pnpm tsgo --noEmit
+pnpm tsgo --noEmit

.nvmrc

@@ -1 +1 @@
-22.16.0
+22.16.0

.oxlintrc.json

@@ -32,6 +32,7 @@
     "prefer-default-export": "off",
     "yoda": "off",
     "new-cap": "off",
+    "no-named-export": "off",
     "id-length": "off",
     "react_perf/jsx-no-jsx-as-prop": "off",
     "no-nested-ternary": "off",

README.md

@@ -129,6 +129,7 @@ pnpm i
 - Copy the env.example file into .env
 - Setup google oauth required for auth https://next-auth.js.org/providers/google or Email provider by setting SMTP details
 - Login to minio console using `splitpro` user and password `password` and [create access keys](http://localhost:9001/access-keys/new-account) and the R2 related env variables
+- If you want to use bank integration please create a free account on [GoCardless](https://gocardless.com/bank-account-data/) or [Plaid](https://plaid.com) and then enter the the related env variables, read more in the README_BANKTRANSACTIONS.md` file.
 
 ### Run the app
 

README_BANKTRANSACTIONS.md

@@ -0,0 +1,15 @@
+## Bank Account Connection
+
+> GoCardless is deprecated. Please use Plaid instead.
+
+### To get started with Plaid:
+
+1. Create an account on Plaid.
+2. Obtain your API keys (client_id and secret).
+3. Add the API keys as environment variables in the split-pro repo. See the example in .env.example.
+4. You’re done! ✅
+
+### How to use the bank connection:
+
+1. Connect your bank provider to your split-pro account. Log in to split-pro, go to your account page. If Plaid is set up correctly according to the steps above, you will see a “Connect to bank” option on the account page.
+2. Once the connection is complete, you can start adding bank transactions. Go to Add new expense in either a group or friend page. There you will find “Transactions”. Click it, select the transactions you want to add, and then click “Submit all.”

docker/dev/compose.yml

@@ -2,7 +2,7 @@ name: split-pro-dev
 
 services:
   postgres:
-    image: postgres:16
+    image: ossapps/postgres
     container_name: ${POSTGRES_CONTAINER_NAME:-splitpro-db}
     restart: always
     environment:
@@ -14,6 +14,11 @@ services:
       - database:/var/lib/postgresql/data
     ports:
       - '${POSTGRES_PORT:-5432}:${POSTGRES_PORT:-5432}'
+    command: >
+      postgres
+      -c shared_preload_libraries=pg_cron
+      -c cron.database_name=${POSTGRES_DB:-splitpro}
+      -c cron.timezone=${TZ:-UTC}
 
   minio:
     image: minio/minio

docker/prod/compose.yml

@@ -2,7 +2,7 @@ name: split-pro-prod
 
 services:
   postgres:
-    image: postgres:16
+    image: ossapps/postgres
     container_name: ${POSTGRES_CONTAINER_NAME:-splitpro-db}
     restart: always
     environment:
@@ -20,6 +20,11 @@ services:
     env_file: .env
     volumes:
       - database:/var/lib/postgresql/data
+    command: >
+      postgres
+      -c shared_preload_libraries=pg_cron
+      -c cron.database_name=${POSTGRES_DB:-splitpro}
+      -c cron.timezone=${TZ:-UTC}
 
   splitpro:
     image: ossapps/splitpro:latest

package.json

@@ -52,16 +52,19 @@
     "lucide-react": "^0.544.0",
     "nanoid": "^5.0.6",
     "next": "15.4.7",
-    "next-auth": "^4.24.5",
+    "next-auth": "^4.24.11",
     "next-i18next": "^15.4.2",
     "next-themes": "^0.2.1",
     "nodemailer": "^6.9.8",
+    "nordigen-node": "^1.4.1",
+    "plaid": "^38.1.0",
     "radix-ui": "^1.4.2",
     "react": "19.1.1",
     "react-day-picker": "^9.7.0",
     "react-dom": "19.1.1",
     "react-hook-form": "^7.50.1",
     "react-i18next": "^15.5.3",
+    "react-plaid-link": "4.1.1",
     "sonner": "^1.4.0",
     "superjson": "^2.2.1",
     "vaul": "^1.1.2",