🚀 Hasura Commander

A developer utility for automating Hasura metadata configuration. This tool drops and resets sources, tracks tables and relationships, sets permissions, and configures webhooks — all via code.

📌 Overview

Hasura Commander is designed to simplify and standardize the setup of Hasura GraphQL instances across environments. Rather than manually configuring metadata in the Hasura Console, this tool enables you to manage your metadata using version-controlled YAML and run it through a simple script.

✅ Features

Drop and set data sources
Track tables and define relationships
Configure environment-based webhooks
Set permissions programmatically
Load and apply YAML-based metadata
Designed for CI/CD and team workflows

🧰 Prerequisites

Node.js and TypeScript installed
Hasura URL and Admin Secret for authentication
metadata.yml file present in the root directory
A sample file is available in the utils/ folder

⚙️ Setup Instructions

Clone the repository

git clone https://github.com/erinoggz/Hasura_Commander.git
cd Hasura_Commander

Usage

Run with Node / TypeScript

npx ts-node app.ts -e <HASURA_URL> -s <HASURA_ADMIN_SECRET> -f utils/metadata.yml

Run with Docker

Pull the latest image from Docker Hub:

docker pull erindeji/hasura_command:latest

Then run the container, mounting your local metadata.yml into the container:

docker run --name hasura-commander \
  -v $(pwd)/SetPermissions/metadata.yml:/app/SetPermissions/metadata.yml \
  erindeji/hasura_command:latest \
  -e <HASURA_URL>/ \
  -s <HASURA_ADMIN_SECRET> \
  -f /app/SetPermissions/metadata.yml

🤝 Contributions

Pull requests, issues, and discussions are welcome.
If you have ideas for improving Hasura metadata automation or CI-friendly enhancements, feel free to contribute!

📄 License

This project is licensed under the MIT License.