This repo and product is intentionally managed as Open Source and we aim to use this guide to light our way https://opensource.guide/.
Let us know how we are doing!
JAMBO is a web application based on NEXT.js for building decentralized applications (dApps) on the ixo network or any other cosmos chain. This documentation will guide you through the process of creating your own dApp using JAMBO by forking the repository, configuring your dApp, adding environment variables, testing, and deploying your dApp.
To get started, fork the JAMBO repository on Github by navigating to the repository page and clicking the Fork
button in the upper right-hand corner. Once you've done this, clone the repository onto your computer and follow the next steps locally.
In your newly forked JAMBO repository, you'll need to configure your dApp by updating the configuration file, uploading custom images, and setting up your own theme.
To configure your dApp, go to the constants
folder and open the config.json
file. Here, you can update the necessary fields to reflect your desired configurations. For an overview of each property in the config.json
file, refer to the config.json section below.
Next, upload your custom images into the public/images
folder. These images include your logo, social image, and action images. You can also customize the fallback images and wallet images if you wish.
To set up your custom theme, navigate to the styles
folder and open the variables.scss
file. In this file, update the CSS styles as needed.
After configuring the dApp, it's time to save your changes and push them to the repository.
Before deploying your dApp, you'll need to add the necessary environment variables. This will allow the dApp to use different or multiple chains or chain networks thanks to the cosmos chain resolver. To achieve this, you can either duplicate the example file .env.example
in the root of the project and rename it to .env
or create a new .env
file in the root of the project and configure the environment variables below:
NEXT_PUBLIC_CHAIN_NAMES
: A comma-separated list of names of any Cosmos chain as found in the Cosmos chain registry. The purpose of this variable is to specify which Cosmos chains the dApp should support.NEXT_PUBLIC_ENABLE_DEVELOPER_MODE
: Set this variable to true to allow the dApp to support testing on testnets. Otherwise, it can be ignored and the dApp will only support mainnet.NEXT_PUBLIC_DEFAULT_CHAIN_NETWORK
: Specify the preferred network for the initial load of the dApp if developer mode is active (defaults to devnet). Otherwise, it can be ignored.
Once you've added these variables, you can start a local instance of your dApp with the following terminal command:
npm run dev
// or
yarn dev
After the local instance has started up, you can test your dApp at localhost:3000. If the server fails to start up, ensure that you have the necessary packages installed by running yarn
or npm install
in your terminal. Don't forget to restart your local instance after updating any environment variables.
Once you're satisfied with your dApp, you can proceed with the deployment process. These docs only cover deployment to Netlify, but you can also deploy it via any hosting platform that supports Next.js projects.
To deploy your dApp on Netlify, follow these steps:
- On your Netlify dashboard, click on the
New site from Git
button on the Sites panel. - Select the Git provider where your forked repository is located (e.g., GitHub) and choose the forked repository from the list.
- Configure the deploy settings, including the branch to deploy, build command, and publish directory. Netlify will detect and auto-populate these settings for you if you're not sure what to do.
- Click on the
Deploy site
button to start the deployment process.
Note that the initial deployment will not work without adding your environment variables from step 3 to your Netlify settings. To do this, navigate to your dApp's Site Settings
page on Netlify and click on the Environment Variables
section. There you can add (or edit) your dApp's environment variables as needed.
Once you've added the necessary environment variables, you'll need to redeploy the dApp to reflect the changes. You can do this by clicking on the Trigger deploy
button on the Deploys
panel of your Netlify dashboard.
If you encounter any issues during the deployment process, feel free to consult the Netlify documentation or reach out to the JAMBO community for support.
๐ ๐ ๐ That's it!
By following these steps, you should be able to successfully create your own dApp from JAMBO. If you encounter any issues during the deployment process, consult the documentation of your hosting platform for further instructions.
The config.json file allows you to configure various aspects of your dApp, including its name, description, metadata and actions. Here's an overview of the available configuration options:
siteName
: The name of your dApp.siteUrl
: The URL of your dApp.siteTitleMeta
: The title of your dApp that will appear in the browser's tab.siteDescriptionMeta
: The description of your site that will appear in search engine results.fontUrl
: The URL for the Google Fonts. Leave this property as-is, unless you have a specific font you'd like to use.fontName
: The name of the Google Font used for the site. Leave this property as-is, unless you imported a font viafontUrl
.headerShowName
: Whether or not to display the site name in the header.headerShowLogo
: Whether or not to display the site logo in the header.about
: Information about your site displayed on the about page. This can be a string of HTML or plain text or a link to an external site.termsAndConditions
: The terms and conditions for the usage of your dApp on the terms page. This can be a string of HTML or plain text or a link to an external site.actions
: An array of actions to be used in the dApp. Actions are the main functionality of the dApp and can consist of one or more steps. Each step corresponds to a screen being displayed to the user, where the user can input some sort of data required for the action. Conventionally, the final step is the "review and sign" screen, which allows the user to review the data they have entered and sign the transaction for the action they are performing.
Each action object has the following properties:
id
: A unique identifier for the action (used for routing).name
: The name of the action.description
: A short description of what the action doesimage
: An image associated with the action (stored in /public/images/actions).steps
: An array of steps that make up the action. Each step has an id (from a list of predefined ids which corresponds to a specific screen to display), and a name for the step.
The steps available for actions can be seen in the steps section.
Below is an example configuration for a delegate action, which allows the user to stake tokens to validators. The id property is a unique identifier for the action and is used for navigation and routing, while the image property represents an image associated with the action (hence the image name corresponds with the action's id).
Send | ||
---|---|---|
get_receiver_address | select_token_and_amount | bank_MsgSend |
![]() |
![]() |
![]() |
MultiSend | ||
---|---|---|
get_receiver_address | select_token_and_amount | bank_MsgMultiSend |
![]() |
![]() |
![]() |
Delegate | ||
---|---|---|
get_validator_delegate | select_amount_delegate | staking_MsgDelegate |
![]() |
![]() |
![]() |
Undelegate | ||
---|---|---|
get_delegated_validator_undelegate | select_amount_undelegate | staking_MsgUndelegate |
![]() |
![]() |
![]() |
Redelegate | |||
---|---|---|---|
get_delegated_validator_redelegate | select_amount_redelegate | get_validator_redelegate | staking_MsgRedelegate |
![]() |
![]() |
![]() |
![]() |
Claim Rewards | ||
---|---|---|
distribution_MsgWithdrawDelegatorReward | ||
![]() |
The JAMBO client makes use of the following wallets:
- Keplr: This is a browser extension wallet that allows users to store, manage and interact with their cryptocurrencies securely. It has a number of features including support for multiple chains, staking, governance voting, and more. Docs available here.
- Opera Wallet: This is a mobile wallet that allows users to store, manage and interact with their cryptocurrencies securely. It has features such as a built-in browser, QR code scanner, and support for multiple chains. Docs available here and here.
- WalletConnect: This is a protocol for connecting decentralized applications to mobile wallets with QR code scanning. It is currently being implemented and will soon be available for use with any JAMBO dApp.
First off, thank you for applying your mind and time to improving this repo - it helps the Internet of Impact to save our planet!
Whether you are contributing in your own space-time or following a bounty; we are grateful!
- Fork the repo or submodule.
- Ensure that you sync the fork often.
- Clone your fork and create a branch that conforms to Github naming conventions.
- Implement your changes one at a time and commit regularly to your fork.
- Once your change is completed and passes all of the local tests, create a PR.
- Your change will be reviewed as soon as possible with helpful feedback for your further updates to the change.
- Finally, when everything is good to go and your PR approved, you can squash and merge your branch.
If you want to contribute to the project but aren't sure what to do or how it works, read our Developer Documentation.
This is a Next.js project set up to be instantly deployed to Netlify.
Deployment on Netlify can be configured using netlify.toml
.
Option one: One-click deploy
- Click this button, follow the Netlify prompts to allow access to your GitHub account, and allow it to create a clone of this repository on your account.
- Clone the new repository in your GitHub account
Option two: Manual clone
- Clone this repo:
git clone https://github.com/ixofoundation/jambo.git
- Navigate to the directory and run
npm run dev
- Make your changes
- Connect to Netlify manually (the
netlify.toml
file is the one you'll need to make sure stays intact to make sure the export is done and pointed to the right stuff)
- Install dependencies
npm install
# or
yarn
- Run the development server:
npm run dev
# or
yarn dev
Open http://localhost:3000 to see the application and see changes in your browser by editing pages/index.tsx
.