Table of Contents
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
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 devUsage
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.