Skip to content

Commit

Permalink
removed examples duplications
Browse files Browse the repository at this point in the history
  • Loading branch information
SwiftAdviser committed Aug 3, 2023
1 parent 803ae8b commit 71dc164
Show file tree
Hide file tree
Showing 7 changed files with 65 additions and 107 deletions.
91 changes: 49 additions & 42 deletions docs/develop/dapps/README.md → docs/develop/dapps/README.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,14 @@
# Overview
import Button from '@site/src/components/button'

The best place to start is a TON Hello World guide of how to create your first Web App:
# Overview

- [TON Hello World: Step by step guide for building your first web client](https://ton-community.github.io/tutorials/03-client/)
The best place to start is a Web App guide of how to create your first DApp on TON:

<Button href="/develop/dapps/ton-connect/twa" colorType={'primary'} sizeType={'sm'}>Build a Web App</Button>
<Button href="/develop/dapps/apis/sdk"
colorType="secondary" sizeType={'sm'}>
Choose a SDK
</Button>

## Tools

Expand All @@ -14,10 +19,40 @@ Here you can see links to the most important resources for you to get started wi
- [Testnet](/develop/smart-contracts/environment/testnet.md) — info about the testnet and how to use it.
- [Unfreezer](https://unfreezer.ton.org/) - Unfreeze a TON contract that ran out of gas for rent.


## Telegram Web Apps (TWA)

- [Telegram Web Apps Documentation](https://core.telegram.org/bots/webapps) — full description on Telegram website.

### TWA SDKs

- [ton-defi-org/tonstarter-twa](https://github.com/ton-defi-org/tonstarter-twa) — template for new TWA interaction with TON
- [twa-dev/boilerplate](https://github.com/twa-dev/Boilerplate) — another boilerplate for a new TWA.
- [twa-dev/sdk](https://github.com/twa-dev/sdk) — NPM package for TWA SDK
- [twa-dev/Mark42](https://github.com/twa-dev/Mark42) — Mark42 is a simple lightweight tree-shakable UI library for TWA

:::info Community
Join a special Telegram [Community Chat](https://t.me/+1mQMqTopB1FkNjIy) for TWA developers if you're interested.
:::


## Payments processing

* Toncoin processing
* Jettons (Tokens) processing
* NFT processing
* Metadata parsing

## Examples

If you are a web or bot developer, you may find the following repositories useful:

### Basics

* Jettons (Tokens): [Mint your first Jetton](/develop/dapps/tutorials/jetton-minter)
* NFTs: [Step by step NFT collection minting](/develop/dapps/tutorials/collection-minting)


### JavaScript

* Payment processing using JavaScript:
Expand All @@ -44,51 +79,23 @@ If you are a web or bot developer, you may find the following repositories usefu
- [10+ examples from xssnick/tonutils-go](https://github.com/xssnick/tonutils-go/tree/master/example)
- [7+ examples from tonkeeper/tongo](https://github.com/tonkeeper/tongo/tree/master/example)

## TON SDKs
### ZK

Learn the complete list of The Open Network SDKs from the SDKs page:
* [SDK](/develop/dapps/apis/sdk)
* [Simple ZK on TON](/develop/dapps/tutorials/simple-zk-on-ton)


## Telegram WebApps (TWA)

- [Telegram WebApps Documentation](https://core.telegram.org/bots/webapps) — full description on Telegram website.

### TWA SDKs

- [ton-defi-org/tonstarter-twa](https://github.com/ton-defi-org/tonstarter-twa) — template for new TWA interaction with TON
- [twa-dev/boilerplate](https://github.com/twa-dev/Boilerplate) — another boilerplate for a new TWA.
- [twa-dev/sdk](https://github.com/twa-dev/sdk) — NPM package for TWA SDK
- [twa-dev/Mark42](https://github.com/twa-dev/Mark42) — Mark42 is a simple lightweight tree-shakable UI library for TWA

:::info Community
Join a special Telegram [Community Chat](https://t.me/+1mQMqTopB1FkNjIy) for TWA developers if you're interested.
:::

## Authorization SDK

To add login button to your website or web app use the following:

### TON Connect

[ton-connect](
/develop/dapps/ton-connect) is a unified authorization standard for every wallet in the TON ecosystem. It's supported and developed by Tonkeeper team with tech advisors from TON Community.

#### Documentation

* [Introducing TON Connect](/develop/dapps/ton-connect)
* [TON Connect for Developers](/develop/dapps/ton-connect/developers)
* [TON Connect 2.0 vs 1.0](/develop/dapps/ton-connect/comparison)
* [ton-connect/wallets-list](https://github.com/ton-connect/wallets-list) — list of supported wallets (add yours!)


### Usage examples
### Wallets examples

- [Desktop standard wallet (C++ and Qt)](https://github.com/ton-blockchain/wallet-desktop)
- [Android standard wallet (Java)](https://github.com/ton-blockchain/wallet-android)
- [iOS standard wallet (Swift)](https://github.com/ton-blockchain/wallet-ios)
- [TonLib CLI (C++)](https://github.com/ton-blockchain/ton/blob/master/tonlib/tonlib/tonlib-cli.cpp)

## APIs
### No necessary material?

You have 2 ways here: write tutorial by you own or describe the problem for the community.

- Go to [API](/develop/dapps/apis) section to read more about APIs in TON
<Button href="/contribute/participate"
colorType="primary" sizeType={'sm'}>
Contribute
</Button>
<Button href="https://github.com/ton-community/ton-docs/issues/new?assignees=&labels=feature+%3Asparkles%3A%2Ccontent+%3Afountain_pen%3A&template=suggest_tutorial.yaml&title=Suggest+a+tutorial" colorType={'secondary'} sizeType={'sm'}>Describe your idea</Button>
4 changes: 1 addition & 3 deletions docs/develop/dapps/apis/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -250,7 +250,5 @@ curl -X 'GET' \

## See Also
* [TON Center API](/develop/dapps/apis/toncenter)
* [SDKs](/develop/dapps/apis/sdk)
* [SDKs](/develop/dapps/apis/sdk)
* [Apps Examples](/develop/dapps/examples)
* [List of SDKs](/develop/dapps/apis/sdk)
* [Smart Contract Examples](/develop/smart-contracts/examples)
22 changes: 0 additions & 22 deletions docs/develop/dapps/examples.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/develop/dapps/ton-connect/integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -307,7 +307,7 @@ The results above take the following into consideration:
## Logging out and requesting TonProof
Now we have logged into our webapp, but... how does the backend know that it is the correct party? To verify this we must request the wallet ownership proof.
Now we have logged into our Web App, but... how does the backend know that it is the correct party? To verify this we must request the wallet ownership proof.
This can be completed only using authentication, so we must log out. Therefore, we run the following code in the console:
Expand Down
31 changes: 1 addition & 30 deletions docs/develop/dapps/tutorials/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,33 +2,4 @@ import Button from '@site/src/components/button'

# Overview

Find a tutorial well-suited for your stack across all the materials listed below.

## Basic

* [Step by step NFT collection minting](/develop/dapps/tutorials/collection-minting)
* [Mint your first Jetton](/develop/dapps/tutorials/jetton-minter)

## Telegram bots

### JavaScript

* [Bot for sales of dumplings](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js)

### Python

* [Storefront bot with payments in TON](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot)
* [Bot with own balance](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-2)

## ZK

* [Simple ZK on TON](/develop/dapps/tutorials/simple-zk-on-ton)
## No necessary material?

You have 2 ways here: write tutorial by you own or describe the problem for the community.

<Button href="/contribute/participate"
colorType="primary" sizeType={'sm'}>
Contribute
</Button>
<Button href="https://github.com/ton-community/ton-docs/issues/new?assignees=&labels=feature+%3Asparkles%3A%2Ccontent+%3Afountain_pen%3A&template=suggest_tutorial.yaml&title=Suggest+a+tutorial" colorType={'secondary'} sizeType={'sm'}>Describe your idea</Button>
TODO: remove
10 changes: 5 additions & 5 deletions docusaurus.config.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 8 additions & 4 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -157,7 +157,7 @@ const sidebars = {
},
{
type: 'category',
label: 'Develop Smart Contracts',
label: 'Smart Contracts',
items: [
'develop/smart-contracts/README',
{
Expand Down Expand Up @@ -286,7 +286,7 @@ const sidebars = {

{
type: 'category',
label: 'Develop Apps',
label: 'DApp Development',
items: [
'develop/dapps/README',
{
Expand Down Expand Up @@ -329,7 +329,6 @@ const sidebars = {
'develop/dapps/defi/subscriptions',
],
},
'develop/dapps/examples',
]
},
{
Expand Down Expand Up @@ -375,8 +374,13 @@ const sidebars = {
},
{
type: 'category',
label: 'Wallets',
label: 'Protocol specifications',
items: [
{
type: 'link',
label: 'TON Connect Protocol',
href: 'https://github.com/ton-blockchain/ton-connect',
},
{
type: 'link',
label: 'TON Connect Wallets',
Expand Down

0 comments on commit 71dc164

Please sign in to comment.