{"id":23246496,"url":"https://github.com/openware/baseapp","last_synced_at":"2025-04-05T07:07:04.061Z","repository":{"id":36587313,"uuid":"224188529","full_name":"openware/baseapp","owner":"openware","description":"OpenDAX Trading user interface","archived":false,"fork":false,"pushed_at":"2023-10-04T02:14:46.000Z","size":10879,"stargazers_count":111,"open_issues_count":14,"forks_count":285,"subscribers_count":21,"default_branch":"2-6-stable","last_synced_at":"2025-03-28T10:06:46.368Z","etag":null,"topics":["crypto-exchange-software","cryptocurrency","frontend","opendax","react","trade"],"latest_commit_sha":null,"homepage":"https://www.openware.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-26T12:34:42.000Z","updated_at":"2025-03-18T08:13:56.000Z","dependencies_parsed_at":"2025-01-09T10:14:01.933Z","dependency_job_id":"b98a7982-b3e9-46b3-89ba-e2ac8b9929d5","html_url":"https://github.com/openware/baseapp","commit_stats":null,"previous_names":[],"tags_count":100,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openware%2Fbaseapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openware%2Fbaseapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openware%2Fbaseapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openware%2Fbaseapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openware","download_url":"https://codeload.github.com/openware/baseapp/tar.gz/refs/heads/2-6-stable","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247299832,"owners_count":20916190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crypto-exchange-software","cryptocurrency","frontend","opendax","react","trade"],"created_at":"2024-12-19T07:15:19.210Z","updated_at":"2025-04-05T07:07:04.031Z","avatar_url":"https://github.com/openware.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Cryptocurrency Exchange Platform - Baseapp](https://github.com/openware/meta/raw/main/images/github_baseapp.png)\n\n\u003ch3 align=\"center\"\u003e\n\u003ca href=\"https://www.openware.com/sdk/docs.html#baseapp\"\u003eGuide\u003c/a\u003e \u003cspan\u003e\u0026vert;\u003c/span\u003e \n\u003ca href=\"https://www.openware.com/sdk/api.html\"\u003eAPI Docs\u003c/a\u003e \u003cspan\u003e\u0026vert;\u003c/span\u003e \n\u003ca href=\"https://www.openware.com/\"\u003eConsulting\u003c/a\u003e \u003cspan\u003e\u0026vert;\u003c/span\u003e \n\u003ca href=\"https://t.me/peatio\"\u003eCommunity\u003c/a\u003e\n\u003c/h3\u003e\n\u003ch6 align=\"center\"\u003eComponent part of \u003ca href=\"https://github.com/openware/opendax\"\u003eOpenDAX Trading Platform\u003c/a\u003e\u003c/h6\u003e\n\n---\n\n# OpenDAX BaseApp UI\n## User Interface for Trading and Wallets Management\n\nReact application to build a trading platform interface for use with OpenDAX: https://github.com/openware/opendax\n\nYou can see an example of a live application running at: https://www.openfinex.io/\nIf you need customization from the experts contact us: https://www.openware.com/\n\n## License\n\nPlease note, that BaseApp license only allows Non-Commercial use of this component. To purchase the Commercial license, please contact us at hello@openware.com.\n\n## Install dependencies\n\n```bash\n$ yarn install\n```\n\n## Run in developement mode\n\n```bash\n$ yarn start-mock\n```\nThis command will also start a fake api backend for helping development.\nOnce you happy with the result, save, build an image and run it with OpenDAX docker compose system.\n\n## Execute tests\n\nIn `\u003crootDir\u003e`\n\n```bash\n$ yarn test\n```\n\nCheck test coverage:\n```bash\n$ yarn test -- --coverage --watchAll\n```\n\nFor more options for `jest` run `yarn test --help`.\n\n## Configuration documentation\n\nConfiguration file is located in  `public/config/env.js`\n\n\n| Argument                 | Description                                                  |\n| --------------------- | ------------------------------------------------------------ |\n| `api`    | URLs of `barong`, `peatio`, `applogic` and `ranger` API endpoints. You can use mockserver (\u003chttps://github.com/openware/mockserver\u003e) with default `env.js` values |\n| `minutesUntilAutoLogout`                |  Autologout time in minutes  |\n| `withCredentials`               |  `false` or `true` if you want to include cookies as part of the request(https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Credentials)   |\n| `gaTrackerKey` |  Google Analytics tracker key  |\n| `rangerReconnectPeriod` |  Reconnection time for the Ranger WS service in minutes    |\n| `msAlertDisplayTime` |  Alert message display duration in milliseconds    |\n| `kycSteps` |  List of label names for KYC process    |\n\n## Available Docker build args\n\nWhile building a Docker image you can pass build-dependant arguments using `--build-arg`: \n`docker build -t baseapp:latest\n  --build-arg BUILD_DOMAIN=\"example.com\" .`\n\n| Argument       | Description                                            |\n| -------------- | ------------------------------------------------------ |\n| `BUILD_EXPIRE` | Unix Timestamp of the build expiration date in seconds |\n| `BUILD_DOMAIN` | Domain which you'd like to use during the deployment   |\n\n## Build mobile app\nInstall dependencies using npm. Important for mobile app development.\n```bash\nnpm install\n```\nBuild frontend\n```bash\nyarn build\n```\nGenerate a native project (ios, android)\n```bash\nionic capacitor add \u003cplatform\u003e\n```\nTo build a native app you should have Xcode or Android studio on your local machine.\n\n## Build IOS app\n**1. Install Xcode**\n\nXcode is the IDE for creating native iOS apps. It includes the iOS SDK and Xcode command-line tools. Xcode can be downloaded for free with an Apple account or it can be installed through the App Store.\nOnce Xcode is installed, make sure the command-line tools are selected for use:\n```bash\nxcode-select --install\n```\n**2. Set up a development team**\n\nAll iOS apps must be code signed, even for development. Luckily, Xcode makes this easy with automatic code signing. The only prerequisite is an Apple ID.\n\nOpen Xcode and navigate to **Xcode » Preferences » Accounts**. Add an Apple ID if none are listed. Once logged in, a Personal Team will appear in the team list of the Apple ID.\n\n**3. Create an iOS Simulator**\n\nYou can test your mobile application with a connected Iphone device to the Mac or using IOS Simulator.\nOpen Xcode and navigate to **Window » Devices and Simulators**. Create an **iPhone 11** simulator if one does not already exist.\n\n**4. Set configs**\n\nOpen the `capacitor.config.json` file and modify the `appId` property.\n\nPut the name of BE server:\n```json\n  \"server\": {\n    \"hostname\": \"example.openware.work\"\n  }\n```\n\n**5. Open the project in Xcode.**\n\nLaunch Xcode with a prepared app:\n```bash\nionic capacitor run ios\n```\n\n**6. Check Xcode configuration**\nIn Project navigator, select the project root to open the project editor. Under the **Identity section**, verify that the **Package ID** that was set matches the Bundle Identifier.\n\nIn the same project editor, under the **Signing section**, ensure Automatically manage signing is enabled. Then, select a Development Team. Given a Development Team, Xcode will attempt to automatically prepare provisioning and signing.\n\n**7. Update native app with the changes**\n\nWith each meaningful change, Ionic apps must be built into web assets before the change can appear on iOS simulators and devices. The web assets then must be copied into the native project:\n```bash\nionic capacitor copy ios\n```\n\n**8. Build IOS app**\n\nTo receive an executable app file run 'build' command on Xcode. You need to have an Apple Developer account to be able to extract an executable file from Xcode.\n\n## Build Android app\n**1. Install Android studio**\n\nAndroid Studio is IDE, that provides the fastest tools for building apps on every type of Android device.\n\n**2. Open the `capacitor.config.json` file and modify the `linuxAndroidStudioPath` property.**\n\nRun next command\n```bash\nwhereis android-studio\n```\n\n**3. Build your android application**\n\n```bash\nionic capacitor add android\n```\n\n**4. Launch android application with Android Studio**\n```bash\nionic capacitor run android\n```\n\n**5. Android Studio configuration**\n\nSelect connected android device or configure device simulator, which required\n\n**6. Update app with the changes**\n```bash\nionic capacitor copy android [options]\n```\n\n**7. Set ANDROID_SDK_ROOT variale**\n\nSet android ask path to ANDROID_SDK_ROOT or write sdk.dir variable in android/local.properties file (it doesn't exist as a default)\n\n**8. Build android app**\n\nBuild android app using Android Studio Build tab\n\nor you can build apk file with command line\n\nDebug build:\n\n```bash\n  ionic capacitor copy android \u0026\u0026 cd android \u0026\u0026 ./gradlew assembleDebug \u0026\u0026 cd ..\n```\n\nRelease build:\n\nFor release build you have to create keystore path and keystore alias and run next command:\n\n```bash\n  cd android \u0026\u0026\n  ./gradlew assembleRelease \u0026\u0026\n  cd app/build/outputs/apk/release \u0026\u0026\n  jarsigner -keystore YOUR_KEYSTORE_PATH -storepass YOUR_KEYSTORE_PASS app-release-unsigned.apk YOUR_KEYSTORE_ALIAS \u0026\u0026\n  zipalign 4 app-release-unsigned.apk app-release.apk\n```\n\n## Happy trading with OpenDAX BaseApp UI\n\nIf you have designed something beautiful with it, we would love to see it!\n\nAnd if you have any comments, feedback and suggestions - we are happy to hear from you here at GitHub or at https://openware.com\n\n## Licensing\n\nThis code is open for helping private modification and performing customer demonstration, you can use it for raising capital.\nYou cannot use it for a live platform without getting a commercial license from us.\n\nContact us if you'd like to purchase a commercial license.\n\n## Partners\n\nIf you would like to fork, and modify this UI to create a BaseApp theme, we would be happy to setup a partnership program and sell your work provided a revenue sharing.\n\nMade with love from Paris and Kiev.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenware%2Fbaseapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenware%2Fbaseapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenware%2Fbaseapp/lists"}