Refine vs AdminBro - Comparison Admin Panel Framework

Looking for open source admin panel framework? Here we are going to review two of the best Open Source admin panel frameworks of 2021.

These frameworks that we will talk about have emerged to offer solutions to the same business demands in general. Although the purpose of these two frameworks is the same, the solutions are different from each other. Our goal in this article is to show you these differences and help you find the appropriate framework for your project.

Refine​

Refine is a React-based framework that helps you to develop admin panel, B2B and dashboard that can be fully customized with Ant Design.

Refine directly provides Ant Design components and some hooks to work with those components. These hooks give you the required props for those Ant Design components.

Refine is a collection of helper hooks, components and providers. They are all decoupled from your UI components and business logic, so they never keep you from customizing your UI or coding your own flow.

Refine uses React Query for data processing, caching, and state management. In this respect, you do not need to define anything extra for every cases and model.

Although Refine is a newer framework, it is successful in identifying deficiencies in development and producing solutions accordingly. Using new technologies, it offers users more effective and simpler development options.

Installation​

• Installation is very simple and customizable options can be added.

npm create refine-app@latest demo-refine-project -- -b v3

Features​

• Configuration: One-line setup with superplate. Project setup is very simple. Using superplate you can choose the content of your project and the features you want to add.

• UI: You have full control over the UI elements. Fully customizable, open to use. Works seamlessly with Ant Design.

• Out-of-the-box: Routing, networking, authentication, state management, i18n and UI.

• SSR: Refine can be used with Next.js and Remix to SSR your pages.

• React Location: React Location router provider support

SSR - Next.js Support​

Refine has support for SSR - Next.js. This is an important feature that separates Refine from other frameworks. Thanks to this feature, Refine provides the opportunity to develop B2C applications in addition to B2B and admin panel.

Refine can be used with Next.js to SSR your pages. It doesn't get in the way and follows Next.js conventions and also provides helper modules when necessary.

SSR-Next.js Setup​

npm i @pankod/refine @refinedev/nextjs-router

SSR-Next.js Basic Usage​

<Refine> must wrap your pages in a custom App component. This way your pages are integrated to refine.

import { AppProps } from "next/app";

import { Refine } from "@pankod/refine";
import dataProvider from "@refinedev/simple-rest";
import routerProvider from "@refinedev/nextjs-router";

const API_URL = "https://api.fake-rest.refine.dev";

function MyApp({ Component, pageProps }: AppProps): JSX.Element {
  return (
    <Refine
      routerProvider={routerProvider}
      dataProvider={dataProvider(API_URL)}
    >
      <Component {...pageProps} />
    </Refine>
  );
}

export default MyApp;

For more information on how to add SSR-Next.js to your Refine project ->

Routing​

Refine uses a customized Router Provider to save routes and navigate between pages. Refine offers a much more flexible structure thanks to its routerProvider support.

A router provider must include the following methods:

const routerProvider = {
    useHistory: () => {
        push: (...args) => any,
        replace: (...args) => any,
        goBack: (...args) => any,
    },
    useLocation: () => {
        pathname: string,
        search: string,
    },
    useParams: <Params extends { [K in keyof Params]?: string } = {}>() => Params,
    Prompt: React.FC<PromptProps*>,
    Link: React.FC<any>,
    RouterComponent?: React.FC<any>,
};

To take a look at how other router providers are defined and working

To activate router provider in Refine, we have to pass the routerProvider to the <Refine /> component.

import { Refine } from "@pankod/refine";
import routerProvider from "@refinedev/react-router-v6";

const App: React.FC = () => {
  return <Refine routerProvider={routerProvider} />;
};

import { Refine } from "@pankod/refine";
import routerProvider from "@pankod/refine-react-location";

const App: React.FC = () => {
  return <Refine routerProvider={routerProvider} />;
};

import { Refine } from "@pankod/refine";
import routerProvider from "@refinedev/nextjs-router";

const App: React.FC = () => {
  return <Refine routerProvider={routerProvider} />;
};

You just need to tell the route of your component to the routerProvider.

Data Provider Logic​

A data provider is the place where a Refine app communicates with an API.

A data provider must include following methods:

const dataProvider = {
  create: ({ resource, variables, meta }) => Promise,
  createMany: ({ resource, variables, meta }) => Promise,
  deleteOne: ({ resource, id, meta }) => Promise,
  deleteMany: ({ resource, ids, meta }) => Promise,
  getList: ({ resource, pagination, sorters, filters, meta }) => Promise,
  getMany: ({ resource, ids, meta }) => Promise,
  getOne: ({ resource, id, meta }) => Promise,
  update: ({ resource, id, variables, meta }) => Promise,
  updateMany: ({ resource, ids, variables, meta }) => Promise,
  custom: ({ url, method, sorters, filters, payload, query, headers, meta }) =>
    Promise,
  getApiUrl: () => "",
};

GraphQL Data Provider​

It is well covered by GraphQL data provider Refine and explained step by step in the documentation.

Refine GraphQL data provider is built with qql-query-builder and graphql-request. The purpose here is to send dynamic queries that we can do with qql-query-builder as requests with graphql-request.

Query builder helps us build queries and mutations. We can use these queries with the getList, getMany and getOne methods in our data provider. On the other hand, the create, createMany, update, updateMany, deleteOne and deleteMany methods generate a mutation to send a request.

In order to create a query, we need to specify the fields that we will use from our data provider. Thanks to the MetaDataQuery, we pass these fields to our data provider and start using them.

Basic GraphQL Usage​

import { Refine } from "@pankod/refine";
import routerProvider from "@refinedev/react-router-v6";
import dataProvider, { GraphQLClient } from "@refinedev/graphql";

const client = new GraphQLClient("API_URL");

const App: React.FC = () => {
  return (
    <Refine
      routerProvider={routerProvider}
      dataProvider={dataProvider(client)}
    />
  );
};

When sending the request, we must specify which fields will come, so we send fields in meta to hooks that we will fetch data from.

export const PostList: React.FC<IResourceComponentsProps> = () => {
  const { tableProps, sorter } = useTable<IPost>({
    sorters: {
      initial: [
        {
          field: "id",
          order: "asc",
        },
      ],
    },
    meta: {
      fields: [
        "id",
        "title",
        {
          category: ["title"],
        },
      ],
    },
  });

  const { selectProps } = useSelect<ICategory>({
    resource: "categories",
    meta: {
      fields: ["id", "title"],
    },
  });

  return (
    <List>
      <Table {...tableProps} rowKey="id">
        <Table.Column
          dataIndex="id"
          title="ID"
          sorter={{ multiple: 2 }}
          defaultSortOrder={getDefaultSortOrder("id", sorter)}
        />
        <Table.Column
          key="title"
          dataIndex="title"
          title="Title"
          sorter={{ multiple: 1 }}
        />
        <Table.Column<IPost>
          dataIndex="category"
          title="Category"
          filterDropdown={(props) => (
            <FilterDropdown {...props}>
              <Select
                style={{ minWidth: 200 }}
                mode="multiple"
                placeholder="Select Category"
                {...selectProps}
              />
            </FilterDropdown>
          )}
          render={(_, record) => record.category.title}
        />
        <Table.Column<IPost>
          title="Actions"
          dataIndex="actions"
          render={(_, record) => (
            <Space>
              <EditButton hideText size="small" recordItemId={record.id} />
              <ShowButton hideText size="small" recordItemId={record.id} />
              <DeleteButton hideText size="small" recordItemId={record.id} />
            </Space>
          )}
        />
      </Table>
    </List>
  );
};

query ($sort: String, $where: JSON, $start: Int, $limit: Int) {
    posts (sort: $sort, where: $where, start: $start, limit: $limit) {
        id,
        title,
        category {
            title
        }
    }
}

Here we only make requests for queries that are necessary. As you can see, all you have to do is specify the field you want to select with meta.

Refer to the GraphQL for detailed usage. →

Refine Available Providers​

Connects to any REST or GraphQL custom backend.

• NestJs CRUD: https://github.com/refinedev/refine/tree/master/examples/data-provider-nestjsx-crud
• Airtable: https://github.com/refinedev/refine/tree/master/examples/data-provider-airtable
• Strapi: https://github.com/refinedev/refine/tree/master/examples/data-provider-strapi
• Strapi v4: https://github.com/refinedev/refine/tree/master/examples/data-provider-strapi-v4
• Supabase: https://github.com/refinedev/refine/tree/master/examples/data-provider-supabase
• Hasura: https://github.com/refinedev/refine/tree/master/examples/data-provider-hasura
• Appwrite: https://github.com/refinedev/refine/tree/master/examples/data-provider-appwrite
• Medusa: https://github.com/refinedev/refine/tree/master/packages/medusa

Customization​

• Refine's motivation and main purpose are as follows: "Higher-level frontend frameworks can save you a lot time, but they typically offer you a trade-off between speed and flexibility."
• While the admin panel allows you to make dashboard, B2B and B2C applications quickly, we offer you flexibility in your UI or business model.

UI/UX Customization:​

• Refine, comes ready-made decoupled from the UI, and is used. Refine mostly touches UI components via hooks. The main advantage of this for you is that you can successfully perform any Business request or different case.

Logic Customization:​

• Refine, works flawless with react-query. You don't have to worry about state management in your business model or when you encounter a different situation.

Pricing​

All features of Refine are available as open source.

• Access Control Provider (RBAC, ABAC, ACL, IP, LDAP, etc...)
• Realtime
• Search
• Navigation and more features are available

If you want to get information about the Enterprise, Refine ready to help you for Support and Training. For more info about Enterprise->

Refine Docs & Demo: Documentation - Live Demo

AdminBro​

AdminBro is an open-source package from that adds an auto-generated admin panel to your Node.js application. You provide database models or schemas and AdminBro generates the user interface for you.

You can connect your various databases to the admin interface and perform standard CRUD operations on the records. In this way, it makes it to make changes on your data and provides you with a great deal of convenience.

You can quickly develop and customize the Admin panel with AdminBro.

It provides you with solutions and provides convenience when making admin panel and b2b applications. It is an open source project that has been in development and ongoing development for a long time.

Installation​

We can say that it is difficult to install, but it is clearly explained step by step in the documentation.

Install the AdminBro along with the express plugin

npm install admin-bro @admin-bro/express

Then, we need to install some dependencies express and the express-formidable packages. express-formidable is a peer dependency for AdminBro

npm install express express-formidable

For detailed installation →

Features​

• You can use any data from any source and make changes to the data(create, read, update, delete)
• Custom actions
• Custom resource decorators
• Form validation
• A full-featured control panel can be created.
• Internationalization(i18n)

SSR - Next.js Support​​

AdminBro does not support SSR-Next.js. It only helps you develop B2B and admin panel applications.

Routing​

Adminbro's routing processes are slightly different than others. You can also define the routes of the components that you have created custom here.

const AdminBro = require("admin-bro");
const AdminBroExpress = require("@admin-bro/express");

const express = require("express");
const app = express();

const adminBro = new AdminBro({
  databases: [],
  rootPath: "/admin",
});

const router = AdminBroExpress.buildRouter(adminBro);

The concept of routing is handled in a different way and in general all routing operations are defined through this file.

Data Provider Logic​

It does not have a data provider exactly like other frameworks. It has a different structure. It has created functions for you to control your data. But there are rules that we must follow and do.

AdminBro can be connected to many different types of resources. Right now, they support the following options:

• Mongoose
• Sequelize
• TypeORM

To add resources , you first have to install an adapter for the resource you want to use.

Install the Database Adapter and add resources​

Let's take a look at an example made with the mongoose adapter.

npm install mongoose @admin-bro/mongoose

const AdminBro = require("admin-bro");
const AdminBroExpress = require("@admin-bro/express");
const AdminBroMongoose = require("@admin-bro/mongoose");

const express = require("express");
const app = express();

const mongoose = require("mongoose");

AdminBro.registerAdapter(AdminBroMongoose);

const run = async () => {
  const connection = await mongoose.connect("mongodb://localhost:27017/users", {
    useNewUrlParser: true,
    useUnifiedTopology: true,
  });

  const User = mongoose.model("User", {
    name: String,
    email: String,
    surname: String,
  });

  const adminBro = new AdminBro({
    Databases: [connection],
    rootPath: "/admin",
    resources: [User],
  });
  const router = AdminBroExpress.buildRouter(adminBro);
  app.use(adminBro.options.rootPath, router);

  app.listen(3000, () => {
    console.log("Application is up and running under localhost:3000/admin");
  });
};
run();

Here we first installed and connected mongoose. We then created a model and passed it to the AdminBro resource. AdminBro has built an interface for us where we can list our users. You can also add your own custom adapters and set up custom resources.

The logic is well covered and also well explained in the documentation. But we can say that it is complex compared to other frameworks. It can be difficult to use on big data.

GraphQL Data Provider​

There is no native GraphQL support. It can be supported with 3rd party packages.

https://www.npmjs.com/package/admin-bro-graphql https://github.com/SoftwareBrothers/adminjs/issues/655

Customization​

AdminBro is good at customizing. You can connect your own adapters and customize your resources. These customizations are challenging and complex.

Some customizable features are as follows:

• Customize Resources
• Customize Actions
• Custom Validations
• Customize dashboard

UI/UX Customization:​​

It automatically offers you an interface option that you can use. You can also develop and customize your own components. You can do your own styling and write your own custom components, but for this customization, you need to follow and apply a few steps. It doesn't speed you up in UI development.

For more information about developing your own components ->

Pricing​

All features of Adminbro are open source and accessible.

• Role-Based Access Control
• Content Management System

AdminBro Docs & Demo: Documentation - Live Demo

Conclusion​

We have examined these two frameworks under some headings. Both help you successfully develop admin panel and B2B applications.

We suggest asking some questions to find out which one is more suitable for your project.

At this point, the questions you should ask when choosing these of framework may be as follows:

• How flexible are they in offering solutions to the different business demands we may encounter?

• How difficult will it be to implement the providers and features we will be using?

• If any problem arises, can I easily find a solution from the documentation?

• How dependent am I on this framework when using it in my project and does it offer customization possibilities?

• What does it offer me as an extra feature?

Here Refine directly answers some of your questions. Refine's customized structures (API, Router, i18n, GraphQL provider, etc...) provide you convenience from many points, unlike admin bro. This convenience and perspective provided by Refine can be preferred for many projects. In addition, you can be limited to internal tool/B2B applications with AdminBro. You can develop many different projects with Refine's rich UI library and SSR support.

In this article, we tried to answer these questions. By reading this article, you can choose the appropriate framework for your project and use it.