evolutility-ui-react - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #golang #android #deep-learning #macos #nodejs #java #awesome #cli #kubernetes #security #open-source

evolutility-ui-react

(★ 119)

Framework for building CRUD UIs for Hasura GraphQL with models rather than code.

파일 탐색기

최종 버전 다운로드 (.zip)

- FUNDING.yml
- - bug.png
  - cd.png
  - comics.png
  - contact.gif
  - contact.png
  - music.png
  - resto.gif
  - resto.png
  - star.png
  - todo.gif
  - todo.png
  - user.png
  - wine-bottle.png
  - wine-glass.png
  - wine.gif
- favicon.png
- index.html
- manifest.json
- evol-db-data.sql
- evol-db-schema.sql
- README.md
- - ErrorBoundary.tsx
- - cache.ts
  - dao.ts
  - gqlQueries.ts
- - en.ts
  - i18n.ts
- - all_models.ts
- - DemoRoutes.tsx
  - DocRoutes.tsx
  - EvolRoutes.tsx
- - api.ts
  - model.ts
- - activity.ts
  - dico.ts
  - dicoViews.ts
  - format.test.ts
  - format.tsx
  - localStorage.ts
  - moMa.ts
  - moMaPrep.ts
  - url.ts
  - validation.test.ts
  - validation.ts
- App-custom.scss
- App.scss
- App.tsx
- config.ts
- index.scss
- index.tsx
- serviceWorker.ts
- setupTests.ts
- variables.scss
- vite-env.d.ts
.gitignore
ascii-art.js
eslint.config.mjs
index.html
LICENSE
package-lock.json
package.json
README.md
tsconfig.json
tsconfig.tsbuildinfo
vite.config.ts

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Evolutility-UI-React &middot; [![GitHub license](https://img.shields.io/github/license/evoluteur/evolutility-ui-react)](https://github.com/evoluteur/evolutility-ui-react/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/evolutility-ui-react)](https://www.npmjs.com/package/evolutility-ui-react)

Evolutility-UI-React is a set of **model-driven views** to [Browse](#Browse), [Edit](#Edit), [List](#List), [Cards](#Cards), [Charts](#Charts), [Stats](#Stats), [Overview](#Overview), and [Activity](#Activity).

With it you can easily build CRUD applications by writing models rather than code. It uses [Hasura](https://hasura.io) GraphQL backend. No hand-coding is necessary!

Check out the [live demos](https://evoluteur.github.io/evodemo/#/demos).

![Edit](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/one-edit.png)

### Table of Contents
1. [Installation](#Installation)
2. [Configuration](#Configuration)
3. [Views](#Views) for [One](#ViewsOne), [Many](#ViewsMany) records, and for [Comfort](#ViewsComfort)
4. [Models](#Models)
5. [Backend](#Backend)
6. [License](#License)

<a name="Installation"></a>
## Installation

[**Download**](https://github.com/evoluteur/evolutility-ui-react/archive/master.zip) or **clone** from [GitHub](https://github.com/evoluteur/evolutility-ui-react/).

```bash
# To get the latest stable version, use git from the command line.
git clone https://github.com/evoluteur/evolutility-ui-react
```

or use the [npm package](https://www.npmjs.com/package/evolutility-ui-react):

```bash
# To get the latest stable version, use npm from the command line.
npm install evolutility-ui-react
```

In the Evolutility-UI-React directory, use the command line to type the following:

```bash
# Install dependencies
npm install

# Run the node.js server
npm start

```

In a web browser, go to the url [http://localhost:3000/ the REST endpoints, you also need to install and run [Evolutility-Server-Node](https://github.com/evoluteur/evolutility-server-node) which provides the matching REST endpoints based on the same metadata.

<a name="Configuration"></a>
## Configuration

Configurations options are specified in the file [/src/config.js](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/config.js). They apply to all apps (app specific options are specified in models).

| Option     | Description      | Example             |
|------------|------------------|---------------------|
| apiPath    | Path to GraphQL API. | "https://myapp.hasura.app/v1/graphql" |
| adminSecret | Token for Hasura. | |
| useCache   | Enable/disable data caching. | true |
| cacheDuration | Cache duration in seconds. | 120 (for 2 minutes) |
| filesUrl   | Path to upload files to. | "/pix/" |
| pageSize   | Page size in pagination.  | 50 |
| withActivity | Tracks and shows records activity (last visited and most visited). Currently implemented w/ the browser's localStorage, it will be moved to the server later. | true |
| queryModels | Get models from JSON files or from the database through the API. (not implemented yet) |
| withTimestamp | Tracks and shows timestamp for creation date and last update for every record. The DB tables need timestamp columns "updated_at" and "created_at" for the feature to work. (partial implementation) | true |

<a name="Views"></a>
## Views

For any object, a single model defines UI elements across views in a simple declarative way.

Evolutility-UI-React provides different types of view:

* Views for One - a single record: [Browse](#Browse), [Edit](#Edit).
* Views for Many - a collection of records: [List](#List), [Cards](#Cards), [Charts](#Charts), [Stats](#Stats).

Evolutility uses GraphQL with [Hasura](https://hasura.io).

Notes: Views for actions (search, filter, export) will come later.

<a name="ViewsOne"></a>
## Views for One object

[Browse](#Browse) - [Edit](#Edit)

<a name="Browse"></a>
### Browse
Shows all fields for viewing (read only). Fields are grouped in panels.

![Browse](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/one-browse.png)

Code: [/src/components/views/one/Browse/Browse.jsx](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/components/views/one/Browse/Browse.jsx)

Route: "/{entity}/browse/{id}"

<a name="Edit"></a>
### Edit
This view shows all fields for edition to create or update records.
It automatically performs validation based on the model.
Fields are grouped in panels and tabs.

![Edit](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/one-edit.png)

Code: [/src/components/views/one/Edit/Edit.jsx](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/components/views/one/Edit/Edit.jsx)

Route: "/{entity}/edit/{id}"

<a name="ViewsMany"></a>
## Views for Many objects

[List](#List) - [Cards](#Cards) - [Charts](#Charts) - [Stats](#Stats)

<a name="List"></a>
### List
Gives a tabular view of a collection.

![List](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/many-list.png)

Code: [/src/components/views/many/List/List.jsx](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/components/views/many/List/List.jsx)

Route: "/{entity}/list"

<a name="Cards"></a>
### Cards
Shows records side by side as cards.

![Cards](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/many-cards.png)

Code: [/src/components/views/many/Cards/Cards.jsx](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/components/views/many/Cards/Cards.jsx)

Route: "/{entity}/cards"

<a name="Charts"></a>
### Charts
Draws charts about the collection. Currently bars and pie charts are implemented, a list with count and percentages is also available. Only provided for fields of types like boolean, lov, integer, decimal, date... (not text or textmultilines).

![Charts](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/analytics-charts.png)

Code: [/src/components/views/analytics/Charts/Charts.jsx](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/components/views/analytics/Charts/Charts.jsx)

Route: "/{entity}/charts"

Note: The "Charts" view is currently only implemented for REST, not available with GraphQL yet.

<a name="Stats"></a>
### Stats
Display last update, number of updates in the last week, and for numeric fields the min, max, count, average.

![Stats](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/analytics-stats.png)

Code: [/src/components/views/analytics/Stats/Stats.jsx](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/components/views/analytics/Stats/Stats.jsx)

Route: "/{entity}/stats"

<a name="ViewsComfort"></a>
## "Comfort" views
Display a summary of the object and the latest activity on it.

<a name="Overview"></a>
### Overview
Display a summary of the object and the latest activity on it.

![Overview](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/comfort-overview.png)

Code: [/src/components/views/comfort/Overview/Overview.jsx](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/components/views/comfort/Overview/Overview.jsx)

Route: "/{entity}/"

<a name="Activity"></a>
### Activity
Show list of "last visited" and "most visited" records for the object (stored in the browser's localStorage).

![Activity](https://raw.githubusercontent.com/evoluteur/evolutility-ui-react/main/public/pix/screenshots/comfort-activity.png)

Code: [/src/components/views/comfort/Activity/Activity.jsx](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/components/views/comfort/Activity/Activity.jsx)

Route: "/{entity}/activity"

<a name="Models"></a>
## Models

Each model describe an object and its list of fields. A single model is used for all views (Browse, Edit, List, Cards...).

For any object, all UI views (List, Cards, Edit, Charts...) share the same model.
All Fields are present in the Edit and Browse views. Fields can be flagged with "inMany" to be included in the List and Cards views, or "noCharts" and "noStats" to be excluded from the Charts or Stats views.

### Object

| Property     | Meaning                                 |
|--------------|-----------------------------------------|
| id           | Unique key to identify the entity (used in route and as API parameter). |
| qid          | Entity ID used in GraphQL (may be different from id in route). |
| icon         | Icon file name for the entity (example: "cube.gif"). |
| name         | Object name (singular).    |
| namePlural   | Object name (plural).      |
| title        | Application name.          |
| fields       | Array of [Fields](#Field). |
| groups       | Array of [Groups](#Group). If not provided a single group will be used.   |
| collections  | Array of [Collections](#Collection).      |
| titleField      | Id of the field which value is used as record title. titleField can also be a function.                       |
| titleFunction  | Function to calculate the record title based it's data. Example: titleFunction = (data, model) => data.firstname + " " + data.lastname;       | X   | X   |
| defaultViewOne | To have List and Cards link to Edit instead of Browse, set defaultViewOne="edit". |

<a name="Field"></a>
### Field

Objects have fields.

| Property     | Meaning                               |
|--------------|---------------------------------------|
| id           | Unique key for the field (can be the same as column but doesn't have to be). |
| type         | Field type to show in the UI. Possible field types: <ul><li>boolean (yes/no)</li><li>date</li><li>decimal</li><li>document</li><li>email</li><li>image</li><li>integer</li><li>json</li><li>lov (list of values)</li><li>money</li><li>text</li><li>textmultiline</li><li>time</li><li>url</li></ul> |
| label        | Field description (displayed with an asterisk for required fields).      |
| labelShort   | Optional shorter version of the labels (used in List and Cards views). |
| required     | Determines if the field is required for saving.      |
| readOnly     | If set to true, the field value cannot be changed.   |
| defaultValue | Default field value for new records.    |
| format       | Field format (using moment for date values and numeral for  numeric values). |
| max, min     | Maximum/Minimum value allowed (only applies to numeric fields).      |
| maxLength, minLength | Maximum/Minimum length allowed (only applies to text fields).      |
| regExp       | Regular expression used to validate the field value.     |
| list         | List of  items in the dropdown as an array  of id-text objects (only for fields of "lov" type). If ommited, the list will be  retrieved in the first query by id on that object.   |
| lovIcon      | Set to True to include icon with LOV items(only for fields of "lov" type).    |
| object       | Model id for the object to link to (only for fields of "lov" type).     |
| chartObject | Optional overide for object name in charts (only for "lov" fields). |
| aggregate | Optional overide for aggregation name in charts (only for "lov" fields). |
| inMany       | Determines if the field is present (by default) in lists of records. |
| inSearch     | Determine if the field is used in text searches.  |
| height       | For fields of type "textmultiline", number of lines used in the field (in Browse and Edit views). |
| width        | Field width in Browse and Edit views (in percent of parent width). |
| help         | Optional help on the field. |
| chartType    | Default charts type used for the field ("Bars", "Pie", or "Table"). "Bars" is used if not specified. |
| noCharts     | Exclude field from charts (only applies to fields of type integer, decimal, money, boolean, list of values which are "chartable"). |
| noStats      | Exclude field from Stats.   |

<a name="Group"></a>
### Field Group

Field Groups are used to separate Fields into panels in the Edit and Browse views.

| Property     | Meaning                               |
|--------------|---------------------------------------|
| id           | Unique key for the group. It is optional.            |
| type         | Type of fields group. Only "panel" is currently supported (tab and other types of groups will be added later). |
| label        | Group title displayed in the group header.      |
| fields       | Array of field ids.       |
| width        | Width (in % of the container total width).        |
| help         | Optional help tooltip text.|
| header       | Optional text displayed at the top of the group (just below the group title).|
| footer       | Optional text displayed below the group.    |

Notes:
- Field Groups are optional. By default a single group holds all fields.
- Field Groups are positioned based on their "width" property the same way than fields are positioned inside groups.

<a name="Collection"></a>
### Collection

Multiple details tables can be specified with "collections".

| Property     | Meaning                               |
|--------------|---------------------------------------|
| id           | Unique key for the collection.        |
| title        | Collection title.                     |
| object       | Model.id for the Object to link to.   |
| fields       | Array of fields (objects or ids). Fields in collections can be field objects or just ids of fields in the collection's object.   |
| readOnly     | Specify if the collection is readOnly.   |
| hideIfEmpty  | Hide Collection when it is empty in Edit view (always hidden when empty in Browse view).  |
| help         | Optional help tooltip text.|
| header       | Text to be displayed before the collection.   |
| footer       | Text to be displayed below the collection.    |

Sample model using collections: [Wine Cellar](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/models/organizer/winecellar.js).

### Sample model

The following example is the model for a simple graphic novels inventory app.

```javascript
{
    id: "comics",
    title: "Graphic Novels",
    name: "graphic novel serie",
    namePlural: "graphic novel series",
    icon: "comics.png",
    titleField: "title",
    fields:[
      {
          id: "title", type: "text",
          label: "Title",
          required: true, maxLength: 255,
          width: 100, inMany: true,
      },
      {
          id: "authors", type: "text",
          label: "Authors",
          inMany: true, width: 62,

},
      {
          id: "genre", type: "lov",
          label: "Genre",
          width: 38, inMany: true,
          list: [
            {id: 1, text: "Adventure"},
            {id: 2, text: "Fairy tale"},
            {id: 3, text: "Erotic"},
            {id: 4, text: "Fantastic"},
            {id: 5, text: "Heroic Fantasy"},
            {id: 6, text: "Historic"},
            {id: 7, text: "Humor"},
            {id: 8, text: "One of a kind"},
            {id: 9, text: "Youth"},
            {id: 10, text: "Thriller"},
            {id: 11, text: "Science-fiction"},
            {id: 12, text: "Super Heros"},
            {id: 13, text: "Western"}
          ]
      },
      {
          id: "serie_nb", type: "integer",
          label: "Albums", noCharts: true,
          width: 15, inMany: false
      },
      {
          id: "have_nb", type: "integer",
          label: "Owned",
          width: 15, inMany: false, noCharts: true
      },
      {
          id: "have", type: "text",
          label: "Have",
          width: 15, inMany: false
      },
      {
          id: "language", type: "lov",
          label: "Language",
          width: 17, inMany: true,
          lovIcon: true,
          list: [
            {id: 2, text: 'French', icon:'comics/flags/fr.png'},
            {id: 1, text: 'American', icon:'comics/flags/us.png'}
          ]
      },
      {
          id: "complete", type: "boolean",
          label: "Complete",
          width: 19, inMany: false
      },
      {
          id: "finished", type: "boolean",
          label: "Finished",
          width: 19, inMany: false
      },
      {
          id: "pix", type: "image",
          label: "Cover",
          width: 30, inMany: true
      },
      {
          id: "notes", type: "textmultiline",
          label: "Notes",
          width: 70, height: 7, maxLength: 5000,
          inMany: false
      }
  ],

groups: [
      {
        id:"serie", type: "panel", label: "Serie", width: 70,
        fields: ["title", "authors", "genre",
              "serie_nb", "have_nb", "have",
              "language", "complete", "finished", "notes"
        ]
      },
      {
        id:"pix", type: "panel", label: "Cover", width: 30,
        fields: ["pix"]
      }
  ]
}

```

More sample models: [To-do list](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/models/organizer/todo.js),
[Address book](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/models/organizer/contact.js),
[Restaurants list](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/models/organizer/restaurant.js),
[Wine cellar](https://github.com/evoluteur/evolutility-ui-react/blob/main/src/models/organizer/winecellar.js).

<a name="Backend"></a>
## Backend

You will need to setup the GraphQL backend on [Hasura](https://hasura.io/) with the Evolutility demo database.

<ol><li>You can signup for a <a href="https://cloud.hasura.io/signup" target="h" rel="noopener noreferrer" class="extlink">free account</a> or host it yourself (<a href="https://hasura.io/docs/latest/hasura-cli/quickstart/" target="h" rel="noopener noreferrer" class="extlink">Quickstart Hasura CLI</a>).</li><li>Add a Postgres database to your Hasura setup.</li><li>Add the demo tables by running the SQL script <a href="https://github.com/evoluteur/evolutility-ui-react/blob/main/sql/evol-db-schema.sql" target="sql-s" rel="noopener noreferrer" class="extlink">evol-db-schema.sql</a>.</li><li>Populate your database with sample data by running <a href="https://github.com/evoluteur/evolutility-ui-react/blob/main/sql/evol-db-data.sql" target="sql-d" rel="noopener noreferrer" class="extlink">evol-db-data.sql</a></li><li>Add relationships in Hasura console.<div class="rels"><div>Relationships on <strong>comics</strong> table:<ul><li>genre (Object): comics / genre_id -&gt; comics_genre / id</li><li>language (Object): comics / language_id -&gt; comics_language / id</li></ul></div><div>Relationships on <strong>comics_genre</strong> table:<ul><li>comics (Array): comics_genre / id =&gt; comics / genre_id</li></ul></div><div>Relationships on <strong>comics_language</strong> table:<ul><li>comics (Array): comics_language / id =&gt; comics / language_id</li></ul></div><div>Relationships on <strong>contact</strong> table:<ul><li>category (Object): contact / category_id -&gt; contact_category / id</li></ul></div><div>Relationships on <strong>contact_category</strong> table:<ul><li>contacts (Array): contact_category / id =&gt; contact / category_id</li></ul></div><div>Relationships on <strong>music_album</strong> table:<ul><li>artist (Object): music_album / artist_id -&gt; music_artist / id</li><li>tracks (Array): music_album / id -&gt; music_track / album_id</li></ul></div><div>Relationships on <strong>music_artist</strong> table:<ul><li>albums (Array): music_artist / id -&gt; music_album / artist_id</li></ul></div><div>Relationships on <strong>music_genre</strong> table:<ul><li>tracks (Array): music_genre / id -&gt; music_track / genre_id</li></ul></div><div>Relationships on <strong>music_track</strong> table:<ul><li>album (Object): music_track / album_id -&gt; music_album / id</li><li>genre (Object): music_track / genre_id -&gt; music_genre / id</li></ul></div><div>Relationships on <strong>restaurant</strong> table:<ul><li>cuisine (Object): restaurant / cuisine_id -&gt; restaurant_cuisine / id</li><li>price (Object): restaurant / price_id -&gt; restaurant_price / id</li></ul></div><div>Relationships on <strong>restaurant_cuisine</strong> table:<ul><li>restaurants (Array): restaurant_cuisine / id =&gt; restaurants / cuisine_id</li></ul></div><div>Relationships on <strong>restaurant_price</strong> table:<ul><li>restaurants (Array): restaurant_price / id =&gt; restaurants / price_id</li></ul></div><div>Relationships on <strong>task</strong> table:<ul><li>category (Object): task / category_id -&gt; task_category / id</li><li>priority (Object): task / priority_id -&gt; task_priority / id</li></ul></div><div>Relationships on <strong>task_category</strong> table:<ul><li>tasks (Array): task_category / id =&gt; task / category_id</li></ul></div><div>Relationships on <strong>task_priority</strong> table:<ul><li>tasks (Array): task_priority / id =&gt; task / priority_id</li></ul></div><div>Relationships on <strong>wine</strong> table:<ul><li>wine_tastings (Array): wine / id -&gt; wine_tasting / wine_id</li><li>bsize (Object): wine / bsize_id -&gt; wine_bsize / id</li><li>country (Object): wine / country_id -&gt; wine_country / id</li><li>grape (Object): wine / grape_id -&gt; wine_grape / id</li><li>score (Object): wine / score_id -&gt; wine_score / id</li><li>type (Object): wine / type_id -&gt; wine_type / id</li></ul></div><div>Relationships on <strong>wine_bsize</strong> table:<ul><li>wines (Array): wine_bsize / id =&gt; wine / bsize_id</li></ul></div><div>Relationships on <strong>wine_country</strong> table:<ul><li>wines (Array): wine_country / id =&gt; wine / country_id</li></ul></div><div>Relationships on <strong>wine_grape</strong> table:<ul><li>wines (Array): wine_grape / id =&gt; wine / grape_id</li></ul></div><div>Relationships on <strong>wine_score</strong> table:<ul><li>wines (Array): wine_score / id =&gt; wine / score_id</li></ul></div><div>Relationships on <strong>wine_tasting</strong> table:<ul><li>wine (Object): wine_tasting / wine_id -&gt; wine / id</li></ul></div><div>Relationships on <strong>wine_type</strong> table:<ul><li>wines (Array): wine_type / id =&gt; wine / type_id</li></ul></div></div></li><li>In Evolutility, change the "apiPath" and "adminSecret" in the ./src/config.js file.</li></ol>

<a name="License"></a>
## License

Copyright (c) 2026 [Olivier Giulieri](https://evoluteur.github.io/).

Evolutility-UI-React is released under the [AGPL-3.0 license](http://github.com/evoluteur/evolutility-ui-react/blob/main/LICENSE).

To suggest a feature or report a bug: [https://github.com/evoluteur/evolutility-ui-react/issues](https://github.com/evoluteur/evolutility-ui-react/issues)