0.49.0 • Published 3 months ago

quasar-app-extension-restboard v0.49.0

Weekly downloads
-
License
MIT
Repository
github
Last release
3 months ago

quasar-app-extension-restboard

A starter kit to install Restboard in a fresh new Quasar Framework project

Install

quasar ext add restboard

Quasar CLI will retrieve it from the NPM registry and install the extension to your project.

Uninstall

quasar ext remove restboard

Overview

This extension installs and wires all Restboard dependencies and provides a clean and working application built on top of default Quasar Framework starter kit:

PackageDescription
rb-core-moduleThe Restboard core module. It provides base classes and interfaces for resource definition and management
rb-data-provider-json-serverA reference data provider to interact with a JSON-based REST API
rb-auth-provider-simpleA simple reference auth provider to include basic authentication & authorization management
quasar-app-extension-rb-uiThe Restboard UI kit. It provides handy components to cover common use cases when creating admin panels and dashboards.

While this is the best way to include automatically all the features of Restboard in your project, you can also decide to manually install just some of the mentioned packages according to your needs.

For example, if you just want to use resources and providers without the optional Restboard UI kit, you can just install the following packages:

# The Restboard core module (required)
npm i --save rb-core-module

# Data and auth providers (optional, you can replace them with your owns)
npm i --save rb-data-provider-json-server
npm i --save rb-auth-provider-simple

At this point you are free to structure and organize your resources as you prefer, while the suggested approach is to add a src/boot/rb.js file in your Quasar project with the following content:

// src/boot/rb.js
import resources from "../resources";

export default ({ app }) => {
  function install(Vue) {
    if ("config" in Vue && Vue.config.globalProperties) {
      // Vue 3.x
      Vue.config.globalProperties.$rb = resources;
    } else {
      // Vue 2.x
      Vue.prototype.$rb = resources;
    }
  }

  app.use(install);
};

Now, you can create a src/resources.js file when you can define all your project resources:

// src/resources.js
import { createResource } from 'rb-core-module'

const users = createResource({
  ...
})

export default {
  users,
  // other resources...
}

Layouts

NameDescription
FullPageFormLayoutA layout used to display a page with a single, full-page form
MainLayoutA layout used to display a page with a header, sidebar and main content area

Pages

NameDescription
IndexPageA dashboard main page
LoginPageA page displaying a login form
MasterDetailPageA page displaying a resource collection with the ability to select and show details of one of them
PivotTablePageA page displaying a pivot table (also known as cross-table)
ProfilePageA page displaying current user profile details
RecoverPasswordPageA page displaying a password recovery form
ResourceGridPageA page displaying a resource collection as a grid of items
ResourceTablePageA page displaying a collection as a table of items

CLI

A CLI (Command-Line Interface) is provided out-of-the-box to add new resources to your app:

# or: npx restboard -v
$ npx rb -v

# To show help:
$ npx rb -h 

# To create a new resource at src/resources/posts.js
$ npx rb create:resource posts

# equivalent to:
$ npx rb c:r posts

Contribute

If you want, you can also freely donate to fund the project development:

Donate

Have you found a bug?

Please open a new issue on:

https://github.com/restboard/quasar-app-extension-restboard/issues

License

Copyright (c) Emanuele Bertoldi

MIT License

0.49.0

3 months ago

0.48.0

3 months ago

0.47.1

3 months ago

0.47.2

3 months ago

0.47.0

3 months ago

0.46.0

4 months ago

0.46.1

4 months ago

0.45.1

4 months ago

0.44.0

4 months ago

0.45.0

4 months ago

0.43.0

5 months ago

0.43.1

5 months ago

0.43.2

5 months ago

0.41.0

6 months ago

0.36.4

7 months ago

0.38.0

7 months ago

0.42.2

6 months ago

0.42.0

6 months ago

0.42.1

6 months ago

0.40.0

6 months ago

0.40.1

6 months ago

0.39.1

6 months ago

0.39.0

6 months ago

0.37.1

7 months ago

0.37.0

7 months ago

0.39.2

6 months ago

0.36.3

8 months ago

0.36.2

9 months ago

0.36.1

9 months ago

0.36.0

9 months ago

0.34.0

1 year ago

0.35.0

1 year ago

0.33.0

1 year ago

0.32.0

1 year ago

0.30.0

2 years ago

0.29.0

2 years ago

0.29.1

2 years ago

0.31.2

2 years ago

0.31.1

2 years ago

0.31.0

2 years ago

0.28.0

2 years ago

0.26.2

2 years ago

0.27.0

2 years ago

0.21.0

2 years ago

0.20.0

2 years ago

0.26.1

2 years ago

0.26.0

2 years ago

0.25.0

2 years ago

0.24.0

2 years ago

0.23.0

2 years ago

0.22.0

2 years ago

0.19.0

2 years ago

0.19.1

2 years ago

0.18.1

2 years ago

0.11.0

2 years ago

0.10.1

2 years ago

0.12.0

2 years ago

0.11.1

2 years ago

0.10.2

2 years ago

0.13.0

2 years ago

0.12.1

2 years ago

0.10.3

2 years ago

0.14.0

2 years ago

0.15.0

2 years ago

0.16.0

2 years ago

0.17.0

2 years ago

0.18.0

2 years ago

0.10.0

2 years ago

0.9.0

2 years ago

0.8.0

2 years ago

0.7.1

2 years ago

0.5.0

2 years ago

0.7.0

2 years ago

0.6.1

2 years ago

0.6.0

2 years ago

0.4.0

2 years ago

0.3.1

2 years ago

0.3.0

2 years ago

0.2.0

2 years ago

0.1.0

3 years ago

0.0.4

3 years ago

0.0.3

3 years ago

0.0.2

3 years ago

0.0.1

3 years ago