Martin 0d47ce0d57 Merge pull request #2423 from DzhideX/sumer-update-tokenomics-operation 3 жил өмнө
..
.storybook c44874008d Enable storybook 4 жил өмнө
docker 4fb6768f3f Move to subfolder 4 жил өмнө
img ac5952ef16 Move to subfolder 4 жил өмнө
packages 0d47ce0d57 Merge pull request #2423 from DzhideX/sumer-update-tokenomics-operation 3 жил өмнө
scripts 81b559d27f Alexandria deployment landing page 4 жил өмнө
test b29a355795 Adjustments following new apps introduction 4 жил өмнө
.123trigger b29a355795 Adjustments following new apps introduction 4 жил өмнө
.babelrc.js ac5952ef16 Move to subfolder 4 жил өмнө
.codeclimate.yml ac5952ef16 Move to subfolder 4 жил өмнө
.dockerignore b29a355795 Adjustments following new apps introduction 4 жил өмнө
.editorconfig ac5952ef16 Move to subfolder 4 жил өмнө
.env-example 4fb6768f3f Move to subfolder 4 жил өмнө
.eslintignore 18dba8532d Directory cleanup 4 жил өмнө
.eslintrc.js 6d90afa998 Linter: Manual fixes 4 жил өмнө
.gitignore b29a355795 Adjustments following new apps introduction 4 жил өмнө
.gitlab-ci.yml ac5952ef16 Move to subfolder 4 жил өмнө
.npmignore ac5952ef16 Move to subfolder 4 жил өмнө
.nvmrc ac5952ef16 Move to subfolder 4 жил өмнө
.prettierignore 77557015db prevent accidental prettier applying to pioneer/ 4 жил өмнө
.stylelintrc 4fb6768f3f Move to subfolder 4 жил өмнө
.travis.yml ac5952ef16 Move to subfolder 4 жил өмнө
BOUNTIES.md ac5952ef16 Move to subfolder 4 жил өмнө
CHANGELOG.md b29a355795 Adjustments following new apps introduction 4 жил өмнө
CONTRIBUTING.md ac5952ef16 Move to subfolder 4 жил өмнө
Dockerfile ac5952ef16 Move to subfolder 4 жил өмнө
I18N.md 4fb6768f3f Move to subfolder 4 жил өмнө
LICENSE ac5952ef16 Move to subfolder 4 жил өмнө
README.md 855b8ab75d separate building of npm packages, docker images and cargo crates 3 жил өмнө
babel.config.js b29a355795 Adjustments following new apps introduction 4 жил өмнө
deployment.extras.yml ac5952ef16 Move to subfolder 4 жил өмнө
deployment.template.yml ac5952ef16 Move to subfolder 4 жил өмнө
env.sh 4fb6768f3f Move to subfolder 4 жил өмнө
gh-pages-refresh.sh ac5952ef16 Move to subfolder 4 жил өмнө
i18next-scanner.config.js b29a355795 Adjustments following new apps introduction 4 жил өмнө
jest.config.js b29a355795 Adjustments following new apps introduction 4 жил өмнө
lerna.json b29a355795 Adjustments following new apps introduction 4 жил өмнө
package.json 6d9153d042 pioneer and nodejs fixes 3 жил өмнө
tsconfig.json ceb3cfb862 Media page with link to Atlas and CLI 3 жил өмнө
tsfmt.json ac5952ef16 Move to subfolder 4 жил өмнө
types.json ac5952ef16 Move to subfolder 4 жил өмнө
yarn.lock b29a355795 Adjustments following new apps introduction 4 жил өмнө

README.md

Content Directory

A Portal into the Joystream network. Provides a view and interaction layer from a browser.

This can be accessed as a hosted application via https://testnet.joystream.org.

overview

The repo is split into a number of packages, each representing an application. These are -

  • apps This is the main entry point. It handles the selection sidebar and routing to the specific application being displayed.
  • apps-electron Desktop app running apps.
  • page-accounts A basic account management app.
  • page-address-book A basic address management app.
  • page-explorer A simple block explorer. It only shows the most recent blocks, updating as they become available.
  • page-extrinsics Submission of extrinsics to a node.
  • page-js An online code editor with @polkadot-js/api access to the currently connected node.
  • page-settings A basic settings management app, allowing choice of language, node to connect to, and theme
  • page-staking A basic staking management app, allowing staking and nominations.
  • page-storage A simple node storage query application. Multiple queries can be queued and updates as new values become available.
  • page-toolbox Submission of raw data to RPC endpoints and utility hashing functions.
  • page-transfer A basic account management app, allowing transfer of Units/DOTs between accounts.

In addition the following libraries are also included in the repo. These are to be moved to the @polkadot/ui repository once it reaches a base level of stability and usability. (At this point with the framework being tested on the apps above, it makes development easier having it close)

  • react-components A reactive (using RxJS) application framework with a number of useful shared components.
  • react-signer Signer implementation for apps.
  • react-query Base components that use the RxJS Observable APIs

development

Contributions are welcome!

To start off, this repo (along with others in the @polkadot family) uses yarn workspaces to organise the code. As such, after cloning dependencies should be installed via yarn, not via npm, the latter will result in broken dependencies.

To get started -

  1. Clone the repo locally, via git clone https://github.com/joystream/joystream <optional local path>
  2. Ensure that you have a recent LTS version of Node.js, for development purposes Node >=10.13.0 is recommended.
  3. Ensure that you have a recent version of Yarn, for development purposes Yarn >=1.10.1 is required.
  4. Install the dependencies by running yarn
  5. Ready! Now you can launch the UI (assuming you have a local Polkadot Node running), via yarn run start
  6. Access the UI via http://localhost:3000

Storybook

There is a StoryBook implementation, the UI for which can be started with yarn storybook and then accessed in a browser via http://localhost:3001 (and the server will open a new browser tab by default when it starts).

Story code can be placed anywhere in the packages directory, and will be detected as long as the file name ends in `.stories.tsx. Stories should be defined in the Component Story Format (CSF) for consistency.

There are several StoryBook addons available, the most useful of which is Knobs, which allows props to be altered in real time.

Note that currently StoryBook only allows for stateless components; it has no connection to polkadot.js or any Substrate node. This means that existing components, which are often tightly coupled with the Polkadot API, cannot be used in storybook.