• About
  • How it looks
  • Motivation
  • Why you should try Hadmean
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Features
• Roadmap
• Support
• Project assistance
• Contributing
• Authors & contributors
• Security
• License
• Built With

About

Hadmean is a admin dashboard framework that build itself based on your database schema and your configurations. It is all batteries included and extremely customizable

How it looks

Motivation

There are lot of good internal dashboard tools out there, The ones bundled with your framework are usually good but not usually highly customizable so they usually dont end up in your clients hand. The good ones are paid for and the free version are usually heavily restricted and they usually require weeks to master with some techinical know-how of SQL and javascript

Hadmean takes another approach to building internal apps by building all the features you will ever need based on the metadata of your database which you can also edit in the app and allowing you to toogle off the ones you dont need

Why you should try Hadmean

• It is free
• Easy to setup, You setup it all up literally as fast you can type your DB credentials
• Little learning curve with almost zero technical knowledge requirement
• Lot of features that you will expect from a paid solution
• It is not tied to any language or framework
• Lastly, It is open source, It doesn't get more customizable than that

Getting Started

Prerequisites

• Git
• Node.js
• Yarn
• Supported database (MySQL, Postgres, MsSQL, SQLite)

Installation

# Clone this repository
$ git clone https://github.com/hadmean/hadmean <project_name>

# Go into the repository
$ cd <project_name>

# Install dependencies
$ yarn install

# Run the app
$ npm run dev

Usage

After installation, You will be asked to provide your database credentials and create your admin account then you will be able to start using the application

Features

• Authentication
• Role and Permissions
• Rich text editor
• Users management
• Deep navigation
• CRUD
• Data Count
• Relationships
• Synced DB Validation
• Fields selection/ ordering
• Cache configurations
• Credentials Storage
• Disabling/Hiding of forms
• Introspection
• Selection Colors
• Form validation
• Filters

Roadmap

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

• Top Feature Requests (Add your votes using the 👍 reaction)
• Top Bugs (Add your votes using the 👍 reaction)
• Newest Bugs

Support

Reach out to the maintainer at one of the following places:

• GitHub Discussions
• Contact options listed on this GitHub profile

Project assistance

If you want to say thank you or/and support active development of Hadmean:

• Add a GitHub Star to the project.
• Tweet about Hadmean.
• Write interesting articles about Hadmean on Dev.to, Medium or your personal blog.

Together, we can make Hadmean better!

Contributing

First off, thanks for taking the time to contribute! Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

Please read our contribution guidelines, and thank you for being involved!

Authors & contributors

The original setup of this repository is by Ayobami Akingbade.

For a full list of all authors and contributors, see the contributors page.

Security

Hadmean takes security at heart and follows all known good practices of security, but 100% security cannot be assured. Hadmean is provided "as is" without any warranty. Use at your own risk.

For more information and to report security issues, please refer to our security documentation.

Built With

• KnexJS
• React
• NextJS
• Typescript
• React Query
• React Table
• React Final Form
• Styled-components
• Class Validator
• Zustand
• Prismjs

License

This project is licensed under the GNU General Public License v3.

See LICENSE for more information.