📝 Documentation

Stone.co

✅ Requirements

Make sure all dependencies have been installed before moving on:

• Node.js >= v8.11.3
• Lerna >= v3.0.0

📦 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

• Conventional commits
• Mamba App Template
• Mamba SDK documentation
• Lerna documentation