While the following guidelines are not an absolute requirement, writing your code by these standards will ensure greater compatibility with the Ark Ecosystem and increases the likelihood your pull request will be accepted.
How to approach
Make sure that all dependencies you use are maintainted and receive new releases on a regular basis. Also try to use npm-check-updates every now and then to check for outdated dependencies in your package.
lib/is intended for code that can run as-is with
src/is intended for code that needs to be build with webpack before it can be used.
build/is for webpack scripts needed to build your project.
dist/is for compiled modules that can be used with other systems.
bin/is for any executable scripts, or compiled binaries used with, or built from your module.
__tests__/is for all of your tests with jest.
If you are developing a module only for server-side use with node.js, your project files should be placed in the
If you are developing a module for server-side and/or browser use, your project files should be placed in the
If you are building a module that needs to run both in the browser and on a server you should use webpack and place the build scripts inside the
If you're using Webpack to bundle your assets, the output should be placed in the
bin folder is for any system modules your package will use or generate, including:
- The compiled
node_gypoutput for your module's binary code.
- Pre-compiled platform binaries.
- package.json/bin scripts for your module.