Community & Support
- Community Forum. Best for: help with building, discussion about best practices.
- GitHub Issues. Best for: bugs and errors you encounter using OneKey.
- Discord. Best for: sharing your ideas and hanging out with the community.
Status
- Alpha: We are testing Supabase with a closed set of customers
- Public: Production-ready
We really need your support, star or watch this repo for latest updates.
🚀 Getting Onboard
- Install node.js LTS version (>= 16)
- Install yarn package management tool
- Install git lfs (some binaries are required for pulling and updating)
After pulling the latest code via the git command line tool, install the project dependencies in the root directory via the yarn command
# Install all JS dependencies and submodule dependencies
yarn
# Install the expo command line tool globally
npm install -g expo-cli
🛠 Develop
Execute the following commands in the root directory to develop different business code
yarn web: Develop web mode, which starts a static server on port 3000 locallyyarn ios: connect to iphone device via USB for development debuggingyarn android: develop androidyarn desktop: development in desktop mode
🗂 Multi-repository directory structure
The repositories are organized using the monorepo model to keep the code on different ends centralized and unaffected, while making it as reusable as possible during the packaging and compilation process
packages/componentsholds UI componentspackages/kitholds reusable page-level UI contentpackages/appAPP codepackages/desktopDesktop electron codepackages/webweb-side codepackages/extensionPlugin-side code
🧲 Install dependencies
Each subdirectory under the packages/ directory is a separate project, and the corresponding monorepo name is the value of the name field in the corresponding directory package.json.
When you need to install a dependency for a subdirectory, just use yarn workspace @onekeyhq/web add axios. With a prefix like yarn workspace @onekeyhq/web, the axios module can eventually be installed in the root directory in the web subproject.
Some of the dependencies have native parts, so you need to go into the packages/app/ios directory and do a pod install after installing the JS dependencies.
😷 Common problems
- The app does not start
Clear the packaging tool cache with the --reset-cache command in yarn native in the root directory. Also run yarn clean in the root directory to clear all dependencies and generated files and then re-run yarn to install the dependencies.
💬 Docs in your languages
| Available Languages |
|---|
| Simplified Chinese / 简体中文 |
| German / Deutsch |
| Japanese / 日本語 |
| French / Français |
| Italian / Italiano |
🔰 Security
- Please report suspected security vulnerabilities in private to dev@onekey.so
- Please do NOT create publicly viewable issues for suspected security vulnerabilities.
- As an open source project, although we are not yet profitable, we try to give some rewards to white hat hackers who disclose vulnerabilities to us in a timely manner.
🙋♂️We're Hiring!
| We are hiring many roles (Remote) 👉 Click here to check all open positions | |
|---|---|
|
|
|