Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update README #276

Merged
merged 1 commit into from
Nov 15, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 80 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,100 @@
# <img src="docs/radix-logo.png" alt="Radix Logo" width="35" height="35"> Radix dApp Toolkit: Tools for building dApps on Radix
<div align="center">
<img src="docs/radix-logo.png" alt="Radix Logo" width="100">

[![npm version](https://badge.fury.io/js/@radixdlt%2Fradix-dapp-toolkit.svg)](https://badge.fury.io/js/@radixdlt%2Fradix-dapp-toolkit)
# Radix dApp Toolkit

# Radix dApp Toolkit - v2 Monorepo
<em> RDT is a TypeScript library that simplifies interactions between your dApp and Radix Wallet. It comes together with a custom HTML element which provides unified interface to display user information.</em>

Look for dApp toolkit and related packages under the [/packages](/packages/) directory. Example applications are under the [/examples](/examples/) directory.
<a href="https://radixdlt.com/"><strong>radixdlt.com</strong></a>

</div>
<p align="center">
<a href="https://docs.radixdlt.com/docs">Radix Docs</a>
·
<a href="CONTRIBUTION.md">Contributing Guidelines</a>
·
<a href="https://github.com/radixdlt/radix-dapp-toolkit/issues">Submit an Issue</a>
</p>

[Apache 2.0 License](LICENSE)
<p align="center">
<a href="LICENSE">
<img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="license" />
</a>
<a href="RADIX-SOFTWARE-EULA">
<img src="https://img.shields.io/badge/EULA-red" alt="eula" />
</a>
<br/>
<a href="https://www.npmjs.com/@radixdlt/radix-dapp-toolkit">
<img src="https://img.shields.io/npm/v/@radixdlt/radix-dapp-toolkit.svg?logo=npm&logoColor=fff&label=NPM+package&color=limegreen" alt="RDT on NPM" />
</a>
<a href="http://discord.gg/radixdlt">
<img src="https://img.shields.io/discord/417762285172555786.svg?logo=discord&logoColor=fff&label=Discord&color=7389d8" alt="Discord conversation" />
</a>
<a href="https://www.npmjs.com/@radixdlt/radix-dapp-toolkit">
<img src="https://img.shields.io/npm/dm/@radixdlt/radix-dapp-toolkit" alt="Discord conversation" />
</a>
</p>

- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Contribution Guidelines](CONTRIBUTION.md)
- [EULA](RADIX-SOFTWARE-EULA)
<hr>

This is merging [Radix dApp Toolkit](https://github.com/radixdlt/radix-dapp-toolkit), [√ Connect Button](https://github.com/radixdlt/connect-button), [Wallet Request SDK](https://github.com/radixdlt/wallet-sdk), [Radix Connect Schemas](https://github.com/radixdlt/radix-connect-schemas) into one mono-repository.
## How to start?

## Migration guide
Install [Node.js] which includes [Node Package Manager][npm]. Use `create-radix-dapp` package - paste following command into your terminal and it will walk you through all required steps!

- [v1 -> v2 migration guide](docs/v2.md)
```bash
npx create-radix-dapp@latest
```

## Versions In This Repository
> [!IMPORTANT]
> **Make sure you go through [README inside RDT package](packages/dapp-toolkit/README.md) for more in-depth information**

- [main](https://github.com/radixdlt/radix-dapp-toolkit/commits/main) - This is all of the current work, which is against v2 of RDT right now
### Official Examples

Most PRs should be made to **main**.
Make sure you take a look at our [official examples repository](https://github.com/radixdlt/official-examples/tree/main/getting-started). It will provide you with examples of not only how to start with RDT but also how to **issue your first cryptocurrency**!

## Important
## Structure

By contributing or commenting on issues in this repository, whether you've read them or not, you're agreeing to the [Contributor Code of Conduct](CODE_OF_CONDUCT.md). Much like traffic laws, ignorance doesn't grant you immunity.
Look for dApp toolkit and related packages under the [/packages](/packages/) directory. Example applications are under the [/examples](/examples/) directory.

## Development

1. `cd` to the repository root
2. `npm install` to install all dependencies
3. `npm run test` will run the test suite
4. `npm run dev` will start the dApp toolkit development servers

## Changelog

Learn about the latest improvements by looking at [GitHub Releases](https://github.com/radixdlt/radix-dapp-toolkit/releases) page

## Contributing

### Contributing Guidelines

Read through our [contributing guidelines](CONTRIBUTION.md) to learn about our submission process, coding rules, and more.

### Want to Help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for [contributing](CONTRIBUTION.md) and start building together with the community!

### Code of Conduct

Help us keep Radix dApp Toolkit open and inclusive. Please read and follow our [Code of Conduct](CODE_OF_CONDUCT.md).

## Community

Join the conversation and help the community.

- [X][X]
- [Discord][discord]
- [YouTube][youtube]
- [GitHub](https://github.com/radixdlt)
- [Blog](https://www.radixdlt.com/blog)

**Love Radix dApp Toolkit? Give our repo a star :star: :arrow_up:.**

[node.js]: https://nodejs.org/
[npm]: https://www.npmjs.com/get-npm
[X]: https://x.com/RadixDLT
[discord]: http://discord.gg/radixdlt
[youtube]: https://www.youtube.com/c/radixdlt
53 changes: 9 additions & 44 deletions packages/dapp-toolkit/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,49 +2,6 @@

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)

- [ Radix dApp toolkit](#-radix-dapp-toolkit)
- [What is Radix dApp Toolkit?](#what-is-radix-dapp-toolkit)
- [Resources](#resources)
- [Building a dApp frontend](#building-a-dapp-frontend)
- [Installation](#installation)
- [Using NPM](#using-npm)
- [Using CDN](#using-cdn)
- [Usage](#usage)
- [Getting started](#getting-started)
- [Login requests](#login-requests)
- [User authentication](#user-authentication)
- [Handle user authentication](#handle-user-authentication)
- [User authentication management](#user-authentication-management)
- [Wallet data requests](#wallet-data-requests)
- [Trigger wallet data request programmatically](#trigger-wallet-data-request-programmatically)
- [Change requested data](#change-requested-data)
- [Data request builder](#data-request-builder)
- [`DataRequestBuilder.persona()`](#datarequestbuilderpersona)
- [`DataRequestBuilder.accounts()`](#datarequestbuilderaccounts)
- [`OneTimeDataRequestBuilderItem.accounts()`](#onetimedatarequestbuilderitemaccounts)
- [`DataRequestBuilder.personaData()`](#datarequestbuilderpersonadata)
- [`OneTimeDataRequestBuilderItem.personaData()`](#onetimedatarequestbuilderitempersonadata)
- [`DataRequestBuilder.config(input: DataRequestState)`](#datarequestbuilderconfiginput-datarequeststate)
- [Handle connect responses](#handle-connect-responses)
- [One Time Data Request](#one-time-data-request)
- [Data Requests Sandbox](#data-requests-sandbox)
- [State changes](#state-changes)
- [Transaction requests](#transaction-requests)
- [Build transaction manifest](#build-transaction-manifest)
- [sendTransaction](#sendtransaction)
- [ROLA (Radix Off-Ledger Authentication)](#rola-radix-off-ledger-authentication)
- [√ Connect Button](#-connect-button)
- [Styling](#styling)
- [Themes](#themes)
- [Modes](#modes)
- [CSS variables](#css-variables)
- [Compact mode](#compact-mode)
- [Sandbox](#sandbox)
- [Setting up your dApp Definition](#setting-up-your-dapp-definition)
- [Setting up a dApp Definition on the Radix Dashboard](#setting-up-a-dapp-definition-on-the-radix-dashboard)
- [Data storage](#data-storage)
- [Examples](#examples)
- [License](#license)

# What is Radix dApp Toolkit?

Expand Down Expand Up @@ -77,7 +34,15 @@ npm install @radixdlt/radix-dapp-toolkit
Add following code to head section of your page. See example usage inside `examples/cdn/index.html`

```html
<script src="https://www.unpkg.com/@radixdlt/[email protected]/dist/radix-dapp-toolkit.bundle.umd.cjs"></script>
<script src="https://cdn.jsdelivr.net/npm/@radixdlt/[email protected]/dist/radix-dapp-toolkit.bundle.umd.js" integrity="sha256-JovDn3asdbgkH7NsCN9iebOTU6yxYCYUCO4Q2JffSF0=" crossorigin="anonymous"></script>
```

## Using `create-radix-dapp`

Use our [CLI tool](https://github.com/radixdlt/create-radix-dapp) to scaffold a new project. Just paste following command into your terminal and it will walk you through all required steps!

```bash
npx create-radix-dapp@latest
```

# Usage
Expand Down