• Stars
    star
    185
  • Rank 208,271 (Top 5 %)
  • Language
    TypeScript
  • Created almost 9 years ago
  • Updated about 1 month ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Kinto Web Administration Console

Kinto Web Administration Console

Build Status

A Web admin UI to manage data from a Kinto server. Demo.

kinto-admin wants to be the pgAdmin for Kinto. You can also use it to build administration interfaces for Kinto-based systems.

Table of Contents


Prerequisites

NodeJS v16+ and npm 8+ should be installed and available on your machine.

Various pre-commit hooks are available to help prevent you from pushing sub-optimal code; to use these, pip install --user pre-commit and pre-commit install. (If you have a .git/hooks/pre-commit.legacy, you can remove it.)

Installation

The easiest way to install and use Kinto Admin on your server is to:

  • download a release from Github.

  • Unzip the directory, then install dependencies:

$ cd kinto-admin && npm install
  • Build the static bundle with:
$ npm run build

This will generate a production-ready assets in a build directory, ready to be served from your server of choice.

Build customization

Use the following options to customize the Kinto Admin build.

Single Server

By default, Kinto Admin gives you the option to connect to multiple Kinto Servers. If you only want Kinto Admin to connect to the server from which it's being served, you can set the SINGLE_SERVER flag as an environment variable:

SINGLE_SERVER=1 npm run build

Building for relative paths

By default, Kinto Admin assumes assets will be served from the root path (/) of the server. If you'd like to serve assets from a different location, set that option with an ASSET_PATH environment variable:

ASSET_PATH="/some/prefix/" npm run build

Hacking on kinto-admin

Clone repository:

$ git clone https://github.com/Kinto/kinto-admin.git

Install packages:

$ cd kinto-admin && npm install

After installation of packages, run the development server.

Development server

The development server should only be used when working on the kinto-admin codebase itself. If you're evaluating Kinto Admin, or building a system that relies on Kinto Admin to administer, you should install Kinto Admin using the installation instructions above.

To run in development mode:

$ npm start

The application is served at localhost:3000, and any React component update will trigger a hot reload.

Tests

To run tests:

$ npm run test-all

FAQ

Browser support

Let's be honest, we're mainly testing kinto-admin on recent versions of Firefox and Chrome, so we can't really guarantee proper compatibility with IE, Safari, Opera and others. We're accepting pull requests though.

How to display a nested field value using the collection displayFields property?

Use the dot notation.

For example, if you have the following record:

{
  "data": {
    "attachment": {
      "filename": "font.ttf"
    }
  }
}

You can use attachment.filename.

We tried our best to make it work with properties having dots in their name.

For instance:

{
  "data": {
    "target": {
      "proof.hash": "abcd",
      "merkle.tree": {
         "file.name": "foobar"
      }
    }
  }
}

If you use target.merkle.tree.file.name it will render the string foobar and target.proof.hash will render abcd.

Releasing

  1. Bump the version number in package.json and run npm i to propagate that version to package-lock.json
  2. Commit with git commit -a -m "Bump vX.Y.Z"
  3. Create the tag with git tag vX.Y.Z
  4. Push the commit with git push
  5. Push the tag with git push origin vX.Y.Z
  6. Publish to GitHub Pages with npm run publish-to-gh-pages
  7. Draft a new release with the changelog
  8. Done!

License

Apache Licence Version 2.0

More Repositories

1

kinto

A generic JSON document store with sharing and synchronisation capabilities.
Python
4,324
star
2

formbuilder

Create your own forms and surveys, get your data back.
JavaScript
625
star
3

kinto.js

An Offline-First JavaScript Client for Kinto.
TypeScript
318
star
4

kinto-react-boilerplate

An UNMAINTAINED Kinto.js+React project boilerplate.
JavaScript
67
star
5

kinto-http.js

A JavaScript HTTP client for the Kinto API.
TypeScript
66
star
6

kinto-http.py

A Python HTTP client for the Kinto API.
Python
52
star
7

kinto-attachment

Attach files to Kinto records
Python
43
star
8

elm-kinto

An Elm client for the Kinto API
Elm
28
star
9

kinto-webpush

Use WebPush to notify clients on collection change.
Python
18
star
10

kinto-emailer

Plugin to manage email notifications on records modification in a collection.
Python
12
star
11

kinto-signer

Digital signatures to guarantee integrity and authenticity of collections of records.
Python
12
star
12

kinto-heroku

Deploy Kinto on Heroku via a one-click button
Python
11
star
13

kinto-fxa

Firefox Accounts authentication support in Kinto
Python
10
star
14

kinto-elasticsearch

Index and query Kinto records via ElasticSearch
Python
10
star
15

kinto-wizard

Save/Load Kinto server content to/from a YAML file
Python
10
star
16

kinto-pusher

Plug Kinto notifications with Pusher.com
Python
8
star
17

kinto-changes

Gather timestamps of several collections into one to optimize server polling
Python
8
star
18

kinto-portier

Kinto authentication backend for Portier
Python
6
star
19

storage-sync

Prototype to wrap Chrome Sync API around Kinto.js
JavaScript
5
star
20

kinto-redis

Kinto Redis storage/cache/permission backends
Python
4
star
21

kinto-slides

Slides about Kinto
HTML
4
star
22

kinto-alwaysdata

Deploy a Kinto on AlwaysData automatically.
Shell
4
star
23

kinto-ldap

A LDAP Basic Auth authentication layer that validate the user/password against a LDAP server.
Python
4
star
24

kinto-http.rs

Kinto Rust Client
Rust
3
star
25

kinto-loadtests

Kinto loadtest based on molotov
Makefile
3
star
26

kinto-node-test-server

A nodejs test server for Kinto.
TypeScript
2
star
27

kinto-website

Website for the kinto ecosystem
HTML
2
star
28

kinto-discovery-lib

JavaScript
1
star
29

kinto-hawk

Hawk authentication support for Kinto
Python
1
star
30

kinto-webextension

Configure your default Kinto server
JavaScript
1
star
31

ESP8266Kinto

Kinto library for ESP8266 Arduino
C++
1
star
32

parse2kinto

Little utility to migrate Parse objects into a Kinto collection.
Python
1
star