CONTRIBUTING GUIDE

Requirements

Meteor Meteor is an open source platform for web, mobile, and desktop used by over half a million developers around the globe to make shipping javascript applications simple, efficient, and scalable.

Only when you run the source code in '/creator' folder of our platform, you need to install Meteor. If you use Steedos as a development tool, you do not need to install Meteor.

MongoDB version >= 4.2. MongoDB is a general purpose, document-based, distributed database built for modern application developers.
Node.js version >= 10.15.1 or above (which can be checked by running node -v). You can use nvm for managing multiple Node versions on a single machine installed.
Yarn version >= 1.5 (which can be checked by running yarn version). Yarn is a performant package manager for JavaScript and replaces the npm client. It is not strictly necessary but highly encouraged.

Prepare For Development

Clone this repository to your local.
Enter to the local folder of this repository by command line.
Run yarn on command line to install the dependent NPM packages.
And then run yarn initSubmodules to init the git submodules for this repository to the ‘apps’ folder.
Then run yarn bootstrap to auto clone git submodules for this repository and link them by lerna.
Start the MongoDB service.

Run One App That Linked To Source Code

The code in the folder '/apps' of this repository is some sample project that developed by Steedos.

Enter to the 'apps' folder of this repository by command line.
And enter to one app folder such as 'steedos-app-crm'.
Then you can start the service just by run yarn start.
Use your browser to access http://127.0.0.1:5000.

You do not need to run yarn on command line to install the dependent NPM packages, because all of the dependence are linked to the souce code or the node_modules of the parent folder.

Here you are using our source code as the development tool, you do not need to install Meteor.

Run The Source Code Of Meteor Bundle

The code in the folder '/creator' of this repository is the souce code of a Meteor application. And all of it's code will build to the '/server' folder as a NPM package named 'steedos-server'.

The code in '/packages' is our souce code of some core NPM packages on which the Meteor application above based on.

If you only need to debug the source code in the '/packages', you shoud just Run One App That Linked To Source Code.

You will need to read the tutorial bellow only when you need to debug the source code of Meteor application in the '/creator' folder.

Environment variable

You should add a .env.local file to the '/creator' folder, and add some content as as the web service url and mongo server url like this:

ROOT_URL=http://127.0.0.1:3100
MONGO_URL=mongodb://127.0.0.1/steedos

settings.json

As a Meteor application in the '/creator' folder, You cannot use steedos-config.yml as the configuration file, but you can add a file named settings.json to do the same.

The content of the setting.json may like this:

{
    "email": {
        "from": "Steedos <noreply@message.steedos.com>"
    },
    "plugins": ["@steedos/app-crm", "@steedos/plugin-enterprise"]
}

Run Creator

Enter to the '/creator' folder of this repository by command line.
Run yarn on command line to install the dependent NPM packages.
Then you can start the service just by run yarn start.
Use your browser to access http://127.0.0.1:3100.

Build Creator

You can run the shell bellow on command line to build all of the source code of '/creator' to the '/server' folder as a NPM package named 'steedos-server'.

cd creator/
export TOOL_NODE_FLAGS="--max-old-space-size=3800"
yarn run build

Test Creator Code After Build

After the command line shell execution of Build Creator above, the built code will be copied automatically to the /server folder.

You can simply Run One App That Linked To Source Code to test the code that has just been built from the source code in the '/creator' folder.

Publish

After passing the test of Creator Code, you should release a new version for both the packages in the '/packages' folder and the package named 'steedos-server' in the '/server' folder, so that to unify all of the packages version numbers.

Commit and submit the code in the '/server' folder that built by Build Creator to Github.
Enter to the root path of this repository on command line.
Run the shell yarn ver on command line, and select the version number.
Run the shell yarn pubBefore_push_submodules on command line, you can see .git_push.js about this command.

When the platform vesion is '<= 1.22', this command is invalid, as an alternative, you should cd to the 'apps' folder, and run the shell bellow in all the project folder one by one.

git add .
/*Replace '${versionInfo.version}' to the version number that you want publish to.*/
git commit -m v${versionInfo.version}
git push

Modify the version number in the file 'package.template.json' in the folder 'packages\project-template-empty'.
Confirm the 'last line sequence' of the file ‘packages\create-steedos-app\index.js’ is LF.
Commit and submit the code to Github.
Run the shell yarn pub to publish, or the shell yarn pub_next for a beta version.
After release, you can run the shell yarn syncToTaoBao for synchronization of Taobao source.

5.8 KiB Raw Blame History Unescape Escape