2019-09-10 07:01:26 +02:00
|
|
|
## Getting Started for Contributors
|
2019-09-09 22:02:23 +02:00
|
|
|
|
|
|
|
Install requires [node-gyp](https://github.com/nodejs/node-gyp), due to a dependancy on [argon2](https://github.com/ranisalt/node-argon2)
|
|
|
|
|
2019-09-10 07:01:26 +02:00
|
|
|
### 1. Prerequisites
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 07:01:26 +02:00
|
|
|
*nodegyp - Windows -* `npm install --global --production windows-build-tools`
|
|
|
|
if you have problems, this might help: https://github.com/nodejs/node-gyp/issues/1278
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 07:01:26 +02:00
|
|
|
*nodegyp - Ubuntu (same for Mac ?)* `sudo apt-get install build-essentials`
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 07:01:26 +02:00
|
|
|
*yarn -* `npm install -g yarn`
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 07:01:26 +02:00
|
|
|
*lerna -* `npm install -g lerna`
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 07:01:26 +02:00
|
|
|
*jest* - `npm install -g jest`
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 11:38:13 +02:00
|
|
|
### 2. Clone this repository
|
|
|
|
|
|
|
|
`git clone git@github.com:Budibase/budibase.git`
|
|
|
|
|
|
|
|
then `cd ` into your local copy...
|
|
|
|
|
|
|
|
### 3. Install and Build
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 11:25:13 +02:00
|
|
|
`lerna bootstrap` will install all modules
|
2019-09-10 07:01:26 +02:00
|
|
|
|
2019-09-10 11:25:13 +02:00
|
|
|
`lerna run build` will build all pakcages
|
2019-09-10 07:01:26 +02:00
|
|
|
|
2019-09-10 11:38:13 +02:00
|
|
|
`lerna run initialise` will initialise your budibase (i.e. create local database)
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 11:25:13 +02:00
|
|
|
### 3. Running
|
2019-09-09 22:02:23 +02:00
|
|
|
|
2019-09-10 11:25:13 +02:00
|
|
|
`lerna run dev:builder` - will run up the builder and server together - i.e. when you want to do some work on the builder
|
2019-09-09 22:02:23 +02:00
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
2019-09-10 11:38:13 +02:00
|
|
|
A work in progress, lives here: https://docs.budibase.com
|
2019-09-09 22:02:23 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|