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 220.127.116.11 (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
- Clone the repo.
git clone https://github.com/plaid/pattern.git cd pattern
- Create the
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.
- Open http://localhost:3000 in a web browser.
- When you're finished, stop the services.
All available commands can be seen by calling
As a modern full-stack application, Pattern consists of multiple services handling different segments of the stack:
databaseruns a PostgreSQL database
serverruns an application back-end server using NodeJS and Express
clientruns a React-based single-page web frontend
ngrokexposes 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.