Hackstub's grist widgets

A fork of the official repository of Grist custom widgets to tailor them to the usecase of the Hackstub, which is a french non-profit (association de droit local Alsace-Moselle à but non-lucratif).

Tailored plugins

• Invoices

How to host them

To use this repository for your own Grist instance:

1. you need to have yarn and npm installed.

sudo apt install yarn npm

3. to copy all the files to your own hosting provider.

git clone https://github.com/hackstub/grist-widget/

4. to recreate the manifest.json file used by Grist (in the root folder of this repo, i.e. /var/www/grist-plugins)

yarn install
yarn run build

To tell your Grist instance to use your repository set the GRIST_WIDGET_LIST_URL environmental variable to URL of the manifest.json file, for example

GRIST_WIDGET_LIST_URL=https:/<your address>/manifest.json npm start

How to tailor your Grist plugins

To run a local widget server in a watch mode, with automatic reload use:

yarn install
yarn run dev

This will start local development server that will host contents of this repository, recreate the manifest.json file on every change and replace grist-plugin-api.js URL to one provided by your own Grist instance, assuming it is available at http://localhost:8484, to override the port use:

GRIST_PORT=<your port> yarn run dev

Next start Grist with an URL pointing to a local widget manifest file:

GRIST_WIDGET_LIST_URL=http://localhost:8585/manifest.json npm start

Alternatively you can run the widget repository development server alongside with the Grist docker image preconfigured to use it:

yarn run grist:serve

or run it in development mode with automatic reload:

yarn install
yarn run grist:dev

Other widgets

There are many other custom widgets than those included here. Some people maintain lists:

• Our beloved Heloise Ouvry's list
• Nick Bush's list