This is a reference application demonstrating an end-to-end Plaid integration, focused on linking items and fetching transaction data.
This is not meant to be run as a production application.
- Docker Version 2.0.0.3 (31259) or higher, installed, running, and signed in. If you're on Windows, check out this link to get set up in WSL.
- Plaid API keys - sign up for a free Sandbox account if you don't already have one
Note: We recommend running these commands in a unix terminal. Windows users can use a WSL terminal to access libraries like make.
- Clone the repo.
git clone https://github.com/plaid/pattern.git cd pattern - Create the
.envfile.cp .env.template .env
- Update the
.envfile with your Plaid API keys. - Start the services. The first run may take a few minutes as Docker images are pulled/built for the first time.
make start
- Open http://localhost:3000 in a web browser.
- When you're finished, stop the services.
make stop
All available commands can be seen by calling make help.
As a modern full-stack application, Pattern consists of multiple services handling different segments of the stack:
databaseruns a PostgreSQL databaseserverruns an application back-end server using NodeJS and Expressclientruns a React-based single-page web frontendngrokexposes a ngrok tunnel from your local machine to the Internet to receive webhooks
We use Docker Compose to orchestrate these services. As such, each individual service has its own Dockerfile, which Docker Compose reads when bringing up the services.
For more information about the individual services, see their readmes, linked in the list above.
- For an overview of the Plaid platform and products, refer to this Quickstart guide.
- Check out this high-level introduction to Plaid Link.
- Find comprehensive information on Plaid API endpoints in the API documentation.
- Questions? Please head to the Help Center or open a Support ticket.