From cc26ca03ec6fb370eba3575036e9f0de145816a1 Mon Sep 17 00:00:00 2001 From: Martin McKeaveney Date: Wed, 15 Jul 2020 12:05:00 +0100 Subject: [PATCH] docs for release --- CONTRIBUTING.md | 24 ++++++++++++++++++- packages/cli/package.json | 2 +- .../materialdesign-components/package.json | 2 +- packages/server/package.json | 2 +- packages/standard-components/package.json | 2 +- 5 files changed, 27 insertions(+), 5 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4ad984a2d7..f84ebf1f69 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -149,7 +149,25 @@ The backend schema, models and records are stored using PouchDB when developing ### Publishing Budibase to NPM -You can publish all the latest versions of the monorepo packages by running: +#### Testing In Electron + +At budibase, we pride ourselves on giving our users a fast, native and slick local development experience. As a result, we use the electron to provide a native GUI for the budibase builder. In order to release budibase out into the wild, you should test your changes in a packaged electron application. To do this, first build budibase from the root directory. +``` +yarn build +``` + +Now everything is built, you can package up your electron application. +``` +cd packages/server +yarn build:electron +``` + +Your new electron application will be stored in `packages/server/dist/`. Open up the executable and make sure everything is working smoothly. + + +#### Publishing to NPM + +Once you are happy that your changes work in electron, you can publish all the latest versions of the monorepo packages by running: ``` yarn publishnpm @@ -157,6 +175,10 @@ yarn publishnpm from your root directory. +#### CI Release + +After NPM has successfully published the budibase packages, a new tag will be pushed to master. This will kick off a github action (can be found at `.github/workflows/release.yml`) this will build and package the electron application for every OS (Windows, Mac, Linux). The binaries will be stored under the new tag on the [budibase releases page](https://github.com/Budibase/budibase/releases). + ### Troubleshooting Sometimes, things go wrong. This can be due to incompatible updates on the budibase platform. To clear down your development environment and start again: diff --git a/packages/cli/package.json b/packages/cli/package.json index d6d9f6b9dc..5d7b2ac31f 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -29,5 +29,5 @@ "uuid": "^7.0.3", "yargs": "^14.2.0" }, - "gitHead": "4a7edd9ebe702c93e8b9da2b74e814d3bb1266e1" + "gitHead": "eff4fa93ca1db11b97b5fdedc0c488413e277eb8" } diff --git a/packages/materialdesign-components/package.json b/packages/materialdesign-components/package.json index 68bda350d2..032693bbbd 100644 --- a/packages/materialdesign-components/package.json +++ b/packages/materialdesign-components/package.json @@ -52,7 +52,7 @@ ], "version": "0.1.8", "license": "MIT", - "gitHead": "e4e053cb6ff9a0ddc7115b44ccaa24b8ec41fb9a", + "gitHead": "eff4fa93ca1db11b97b5fdedc0c488413e277eb8", "dependencies": { "@material/card": "4.0.0" } diff --git a/packages/server/package.json b/packages/server/package.json index 85e92c49f7..fd9a8543b7 100644 --- a/packages/server/package.json +++ b/packages/server/package.json @@ -95,5 +95,5 @@ "./scripts/jestSetup.js" ] }, - "gitHead": "4a7edd9ebe702c93e8b9da2b74e814d3bb1266e1" + "gitHead": "eff4fa93ca1db11b97b5fdedc0c488413e277eb8" } diff --git a/packages/standard-components/package.json b/packages/standard-components/package.json index 2dce900512..0b068caddc 100644 --- a/packages/standard-components/package.json +++ b/packages/standard-components/package.json @@ -35,7 +35,7 @@ ], "version": "0.1.8", "license": "MIT", - "gitHead": "e4e053cb6ff9a0ddc7115b44ccaa24b8ec41fb9a", + "gitHead": "eff4fa93ca1db11b97b5fdedc0c488413e277eb8", "dependencies": { "@beyonk/svelte-googlemaps": "^2.2.0", "fusioncharts": "^3.15.1-sr.1",