Skip to content

Getting Started

Orbit is an innovative platform layer built for the Internet Computer Protocol (ICP) and designed to extend to other blockchains. Follow this guide to set up and start developing with Orbit.


Prerequisites

Before you begin, ensure you have the following installed:


Step 1: Clone the Orbit Repository

Start by cloning the Orbit repository from GitHub:

Terminal window
git clone https://github.com/dfinity/orbit.git
cd orbit

Step 2: Install Dependencies

Use pnpm to install the project dependencies:

Terminal window
pnpm install

Step 3: Set Up the Development Environment

Run the helper script provided by Orbit to configure the development environment:

Terminal window
./orbit

This script initializes the necessary settings for your environment.


Step 4: Start the Local Development Server

  1. Start the Internet Computer replica in the background:

    Terminal window
    dfx start --clean --pocketic --host 127.0.0.1:4943
  2. Deploy the canisters to the local replica:

    Terminal window
    dfx deploy
  3. Navigate to the wallet application directory:

    Terminal window
    cd apps/wallet
  4. Start the development server:

    Terminal window
    pnpm dev
  5. Open your browser and go to http://localhost:3000 to access the Orbit wallet interface.


Step 5: Explore the Codebase

Here’s a quick overview of the Orbit project structure:

  • Core Logic: Located in the core directory.
  • Wallet Frontend: Found in the apps/wallet directory.
  • Shared Libraries: Available in the libs directory.

Step 6: Contribute to Orbit

If you’d like to contribute:

  1. Read the HACKING.md file for contribution guidelines.
  2. Ensure your code follows the project’s coding standards and includes tests.

Resources


You’re now ready to develop and contribute to Orbit! 🚀