Woovers is a lightweight API simulator built with Bun and Express.
It mimics the core behavior of the Woovi/OpenPIX API, but without requiring official access keys or credentials.
The goal of this project is to provide a simple way to experiment with Pix-like flows in a single environment — including:
- Basic API endpoints and functionalities
- QRCode generation (not real/valid Pix codes xD)
- Webhook simulation
- And more features under development
Important
Woovers is not affiliated with Woovi or OpenPIX.
It’s an unofficial, community-driven project with no guarantees of compatibility or support.
The implementation only mimics the official API superficially, without reproducing all the nuances or updated features.
Woovers is powered by:
- ExpressJS – Minimal and fast HTTP server
- TypeScript – Type safety and developer experience
- SQLite – Lightweight persistence out of the box
- Bun – Modern runtime with blazing fast performance and package management
Make sure you have installed:
- Bun ≥
1.2
-
Copy the environment configuration:
cp .env.example .env
-
Install project dependencies:
bun install
Note: While this project uses Bun as the runtime, you can also use other package managers like
npm install/yarn install/pnpm installto manage dependencies if preferred. -
Start the application:
bun start
By default, the server runs at:
http://localhost:3000
You can update the port in your .env file.
-
Check or create an issue
- Look at the open Issues to see if someone is already working on what you want.
- If not, open a new issue to discuss your idea before starting.
-
Fork the repository
- Create your own copy of the project by forking this repo.
-
Create a feature branch
git checkout -b feat/my-feature
-
Commit your changes
git commit -m "feat: added my feature" -
Push to your fork and open a PR
- Push your branch:
git push origin feat/my-feature
- Open a Pull Request to the
mainbranch. - Assign one reviewer (preferably Scarlet xD).
- Push your branch: