Bruno Collections Hub

A community-driven repository of ready-to-use Bruno API collections
Explore Collections »

Request a Collection · Report Bug · Contribute

Table of Contents

1. About The Project
2. Available Collections
3. Getting Started
4. Usage
5. Contributing
6. Roadmap
7. License
8. Acknowledgments

About The Project

Bruno Collections Hub is a community-driven repository that provides ready-to-use Bruno API collections for popular APIs and services.

Why this project?

• 🔄 Save time — Don't recreate collections from scratch for common APIs
• 🤝 Community-powered — Benefit from collective knowledge and best practices
• 📁 Git-friendly — Bruno's .bru format makes collaboration seamless
• 🔒 Privacy-first — No cloud sync, your data stays local
• ✅ Tested & documented — Each collection comes with examples and documentation

What is Bruno?

Bruno is an open-source API client that stores collections directly on your filesystem using a plain text markup language called Bru. This makes it perfect for version control and team collaboration.

(back to top)

Available Collections

Collection	Description	Status
BetterAuth	Complete authentication API collection for BetterAuth	🚧 In Progress

💡 Want to see a specific API? Request a collection

(back to top)

Getting Started

Prerequisites

• Bruno installed on your machine (v1.0+)
• Git (optional, for cloning)

Installation

Option 1: Clone the entire repository

git clone https://github.com/Romain-Dfs/bruno-collections-hub.git

Then open Bruno and select Open Collection → Navigate to collections/<api-name>

Option 2: Download a specific collection

1. Navigate to the collection folder (e.g., collections/better-auth/)
2. Download the folder as ZIP
3. Extract and open in Bruno

Option 3: Use the "Fetch in Bruno" button

Click the badge in each collection's README to import directly into Bruno:

(back to top)

Usage

1. Configure your environment

Each collection includes environment files in the environments/ folder:

collections/better-auth/
├── environments/
│   ├── local.bru      # For local development
│   └── production.bru # For production testing

Edit the environment file to match your setup:

vars {
  baseUrl: http://localhost:3000
  apiPath: /api/auth
}

vars:secret [
  authToken
]

2. Run requests

1. Open Bruno
2. Select the imported collection
3. Choose your environment (local/production)
4. Execute requests!

3. Run tests via CLI (optional)

cd collections/better-auth
npx @usebruno/cli run --env local

(back to top)

Contributing

Contributions are what make this project thrive! Whether you're adding a new collection, improving existing ones, or fixing bugs — all contributions are welcome.

Quick start

1. Fork the repository
2. Create your branch (git checkout -b collection/amazing-api)
3. Add your collection following our contribution guidelines
4. Commit your changes (git commit -m 'Add AmazingAPI collection')
5. Push to the branch (git push origin collection/amazing-api)
6. Open a Pull Request

📖 Read the full Contributing Guide for detailed instructions and standards.

Top Contributors

(back to top)

Roadmap

• Initial repository structure
• Contribution guidelines
• BetterAuth collection (core endpoints)
• BetterAuth collection (plugins: 2FA, OAuth, Passkey)
• GitHub Actions for collection validation
• Collection submission workflow
• Website for browsing collections
• More collections (Stripe, Supabase, Firebase Auth, etc.)

See the open issues for a full list of proposed features and known issues.

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Acknowledgments

• Bruno — The amazing open-source API client
• BetterAuth — Universal authentication framework for TypeScript
• Best-README-Template — README inspiration

(back to top)