/pos-mamba-sdk

SDK for developing in the Mamba web environment

Primary LanguageJavaScriptApache License 2.0Apache-2.0

The solution that turns a POS(point of Sale) into much more than payment!

Develop applications using only web technology, without worrying about the complications of the capabilities of a POS.

License npm package



📝 Documentation

 Stone.co


✅ Requirements

Make sure all dependencies have been installed before moving on:

📦 Getting Started

With @mamba/cli

# Install the mamba cli globally if doesn't already have it
npm i -g @mamba/cli

# Create a new mamba app at 'my-mamba-app' directory
mamba new app my-mamba-app

? Name: My Mamba App
? Version: 0.0.1
? Description: My new Mamba app

Manually

# Create and enter your new app directory
mkdir my-mamba-app
cd my-mamba-app

# Install the standard mamba app template
npx degit stone-payments/pos-mamba-app-template

⌨️ Development

Once you have completed the installation step, you are ready to start the project!

cd my-mamba-app # Your project folder

# Install its dependencies
npm i

# Run the development server
npm run start

Open your browser and visit http://127.0.0.1:8080 , see more at Development.

🔨 Components usage

For Web Components, install the component / package that you want to use in the project:

npm install @mamba/button # Button component


# If you want to use the dialog component for example:

npm install @mamba/dialog

To import the installed component, simply do one of the following:

<script>
import Button from '@mamba/button';

export default {
  components: { Button }
}
</script>

// or

<script>
export default {
  components: {
    Button: '@mamba/button'
  }
}
</script>

🧰 Commands

  • npm run lint - Lint all style and script files;
  • npm run format - Format all style and script files;
  • npm run link:packages - Create a local link of every package for local developing;
  • npm run test - Run all tests once;
  • npm run test:watch - Run all tests and keep watching for changes;
  • npm run release - Release a new version of the SDK;
  • lerna run x - Execute the x script in all packages;
  • lerna run start --scope=@mamba/component --stream - Run the dev server for a specific component;

Contributing

✏️ Commiting

Our commits follow the Conventional Commits standard:

<type>[optional scope]: <description>

By installing git-cz globally (npm i -g git-cz) it's possible to use git cz instead of git commit for a interactive commit helper.

🔗 Useful links