@dac-software/forms-pl

Forms

This library has forms integrated with SalesForce forms. It can be applied to qarson pl website. Library uses react, typescript, css written in SASS preprocessor.

Developing bundler is webpack.

Build production build made as simple tsc compilation with asset files copies provided

Requirements

• nodejs v10 +
• npm v6.9.0 +

Installation:

Installing dependencies

npm install

Build production library files

npm run build

* Build task build two types of library entrypoints :

• "web" - destined to web include (for example by script tag) with all depedencies built in (like react, redux and other third party libraries)
• "ecma script module" - destined for further bundler processing, it is resolved through simply typescript compiling in package.json statement

  tsc -p tsconfig-prod.json && copyfiles "./lib/**/*.!(tsx|ts|d.ts|html)" "dist/esm" -u 1
  

##Development

Running dev server in standalone mode

npm run start

Running dev mode through bundler in other project. Project should be linked by npm.

npm run build:dev

* build dev emmits files into dist/esm without CSS / files extraction, it is determined by webpack condition on compilation mode

Running tests

npm run test

####Codestyle

We are in consonance with standardx.

Validation codestyle:

npm run codestyle-check-typescript

Automatic fix:

npm run codestyle-typescript-fix

####CI (bitbucket pipelines)

Checks codestyles and run tests

##Compilation summary

	npm start - (standalone dev)	npm run build:dev (imported as esm in higher bundler)	npm run build (production build)
key dist files	none	dist/esm/forms-pl.js	dist/esm/forms-pl.js, dist/forms-pl.js, dist/forms-pl.css
css extraction	no	css in js	esm: css in js, web: extracted
files extraction	no	yes	no (copied)
##App configuration

Forms PL react app requires simple configuration object in window formConfig property.

Example :

 var formConfig = {
          locale: 'pl',
          formApiSfUrl: 'Salesforce form api url',
          formOid: 'salesforce unique environment ID',
      }

Object.defineProperty(window, 'formConfig', { value: formConfig })

NPM publishing:

1. Increase version in package.json
2. Npm login with proper username, password and email

   npm login
   

3. Npm publish (command will trigger prepare npm method which should build files to dist directory)

   npm publish --access=public