Skip to content

Generate powerful admin apps in seconds with just `npx hadmean`. Stop building and maintaining admin apps that you can auto-generate.

License

Notifications You must be signed in to change notification settings

sina930/hadmean

 
 

Repository files navigation

Project license Pull Requests welcome

Maintainability Test Coverage GitHub CI

Table of Contents

About

Hadmean generates powerful admin apps from your database information

  • With just one command
  • Under 30 seconds
  • No tutorial
  • No learning curve
  • No drag and drop
  • No technical skills required
  • Zero maintenance

What you get is a fully functional admin app that is ready to be deployed.

Hadmean will help you focus your engineering resources on building exciting features and not building and maintaining boring and repetitive CRUD apps.

Demo

https://demo.hadmean.com is an example admin app generated with Hadmean without writing any line of code.

Features Walkthrough Video

Click on the image below to see a walkthrough of the many features Hadmean provides.

Watch the video

Motivation

Most internal tool applications make you build from the ground up i.e you get a blank canvas, drag and drop components, and wire them together with SQL and Javascript/Python to satisfy your business requirement. This I believe has many problems.

  • They require some technical knowledge.
  • They require some learning curve.
  • They require time to build.
  • You duplicate a lot of business logic already in your database.
  • You to maintain them.

Hadmean attempts internal tool generation with a new approach by introspecting your database and building a multi-page application based on all the info it can find like your field types, relationships, constraints etc. You literally can have your admin app done in seconds without any tutorial or coding.

Why you should try Hadmean

  • It is free
  • Easiest installation, Just one command to install and run
  • You will always be running the latest version
  • The little learning curve with truly less than 5% technical knowledge requirement
  • Tons of features
  • Language/framework agnostic
  • Lastly, It is open source.

Getting Started

Prerequisites

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

Installation

$ cd <project_name>

$ npx hadmean

That is all, You will be able to see the application on http://localhost:3000.

If you prefer to use Docker, Check the Dockerfile.example file in the root folder of the repo.

Features

  • One line installation
  • Authentication
  • Role and Permissions
  • Users management
  • Dashboard builder
  • CRUD
  • Form validation
  • Powerful form manipulation (hiding fields, disabling fields, editing values before submitting)
  • Relationships
  • Powerful Filters
  • DB Introspection
  • Color Customization
  • Rich text editor
  • Deep navigation
  • Reusable Queries
  • Views
  • Data Count
  • Synced DB Validation
  • Fields selection/ordering
  • Cache
  • Secure Credentials Storage
  • Forms fields customization
  • Selection Colors

Roadmap

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

Support

Join the community at one of the following places:

Project assistance

If you want to say thank you or/and support the 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 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.

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

Built With

License

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

See LICENSE for more information.

About

Generate powerful admin apps in seconds with just `npx hadmean`. Stop building and maintaining admin apps that you can auto-generate.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 99.8%
  • Other 0.2%