Skip to content

Datami's mirror repo (source on Gitlab)

License

Notifications You must be signed in to change notification settings

multi-coop/datami

Repository files navigation

LOGO-DATAMI


Contribute easily to data stored with git but without having to use Github or Gitlab interfaces


Summary


What is Datami for ?

This project aims to create a serie of widgets to interact with ressources stored on Gitlab, Github, or mediawiki :

  • Edit data stored on github or gitlab (csv, md, or json files) ;
  • Allow unidentified users to push on a separate branch and automatically create a pull request ;
  • Create a set of components for modular uses :
    • preview for .csv, .md, .json files or mediawiki ressources, with several choices for preview (table, cards list, ...) ;
    • files edition interfaces ;
    • dataviz for .csv files (barcharts, pies, ...) ;
    • user preferences: language, user token, ...
    • etc...
  • Web integration as modular web component

Websites

Prod deploy   Netlify Status

Preprod deploy


Documentation

Check out our brand new documentation website for technical support :


Project setup

The current project is working with npm 8.3.2 version

To install it, use the command :

npm install -g [email protected]

Then you can install the dependancies and add a dummy .env file based on the example.

nvm use
npm install

# and copy the example .env file
cp example.env .env

Compiles and hot-reloads for development

To run locally Datami you just have to type :

npm run serve

Compiles and minifies for production

npm run build

Run your unit tests

npm run test:unit

Lints and fixes files

npm run lint

Customize configuration

See Configuration Reference.


Testing examples

Some http files are stored in the ./http-tests folder, showing examples of Datami working as a stand-alone widget embedded in a page in a shadow DOM.

Setup :

nvm use 

# Option one - Build the app
npm run build

# Option 2 - Run the app to serve the script
npm run serve

Note : Depending on the option you will chose, you will have to check where to point to the Datami script in the html file. Some files are commented to check the different approaches.

Then you can launch the http server :

nvm use

# Run the server
npm run http

The server will automatically open a page in your brower at http://localhost:8180/html-tests/


Stack

We only used open source packages and technologies, coz' that's what we do... :


Datami is an open source project by the tech cooperative multi