From ee0522909fcfc4c58e004fbad1ba3065346b44e1 Mon Sep 17 00:00:00 2001
From: "Ryan G. Young" <ryoung@ripple.com>
Date: Tue, 9 Mar 2021 11:52:22 -0800
Subject: [PATCH] initial structure and first code samples

---
 .../get-started/get-started-build-apps.md     | 80 +++++++++++++++++++
 dactyl-config.yml                             | 12 +++
 2 files changed, 92 insertions(+)
 create mode 100644 content/tutorials/get-started/get-started-build-apps.md

diff --git a/content/tutorials/get-started/get-started-build-apps.md b/content/tutorials/get-started/get-started-build-apps.md
new file mode 100644
index 0000000000..e4bea6014a
--- /dev/null
+++ b/content/tutorials/get-started/get-started-build-apps.md
@@ -0,0 +1,80 @@
+# Get Started Building Apps on the XRP Ledger
+
+
+When you're working with the XRP Ledger, there are a few things you'll need to manage with your app or integration, whether you're adding XRP into your [wallet](xref: wallets.md), integrating with the [decentralized exchange](xref: decentralized-exchange.md), or [issuing and managing tokens](xref:issued-currencies.md). This tutorial walks you through these common patterns and provides sample code for implementing them. 
+
+Here are the basic steps you'll need to cover for almost any XRP Ledger project:
+
+1. [Generate keys.](#generate-keys)
+2. [Connect to the XRP Ledger.](#connect)
+3. [Query the XRP Ledger.](#query)
+4. [Submit a transaction.](#submit-transaction) 
+5. [Verify results.](#verify-results) 
+
+**Tip:** These steps roughly correspond to the best practices described in the [reliable transaction submission guide](xref:reliable-transaction-submission.md). 
+
+
+## Set up your environment
+
+Requirements for setting up your environment vary depending on the programming lanuage and tools you choose to use in your project; see the docs for the tools and libaries for details specific to the framework you want to work with. 
+
+But regardless of the tools you use, there are a few things you'll need to work with the XRP Ledger.
+
+* Network client - You need a network client to query the XRP Ledger. SDKs and other libraries typically use the framework-native network modules for network connections. If you're only testing or exploring, you could use the [Websocket API](https://xrpl.org/websocket-api-tool.html) or [JSON-RPC](https://xrpl.org/xrp-ledger-rpc-tool.html) tools. 
+* [Account](xref: accounts.md) -  If you want to interact with the Ledger by sumbitting transactions, you'll need an address, an XRP balance, and secret keys to manage the account. To get started on the Testnet or Devnet, you can use the [XRP Faucets](https://xrpl.org/xrp-testnet-faucet.html) to get an address, XRP balances, and keys. 
+
+
+For library-specific requirements, see the README for each project:
+
+* [ripple-lib](https://github.com/ripple/ripple-lib) (JavaScript)
+* [xrpl-py](https://github.com/xpring-eng/xrpl-py) (Python)
+* [xrpl-4j](https://github.com/XRPLF/xrpl4j) (Java)
+
+## Generate keys
+
+You need [keys](https://xrpl.org/cryptographic-keys.html) to sign transactions that you submit to the XRP Ledger. 
+
+For testing and development purposes, you can get keys (and XRP balances) from [XRP Faucets](https://xrpl.org/xrp-testnet-faucet.html).
+
+Otherwise, you should take care to store your keys and set up a [secure signing method](https://xrpl.org/set-up-secure-signing.html). 
+
+To generate keys, you can use any of the following methods:
+
+<!-- MULTICODE_BLOCK_START -->
+
+*JavaScript (ripple-lib)*
+
+```
+return api.generateAddress();
+```
+
+*Python (xrpl-py)*
+
+```
+seed = keypairs.generate_seed()
+public, private = keypairs.derive_keypair(seed)
+```
+
+*Java (xrpl4j)*
+
+```
+WalletFactory walletFactory = DefaultWalletFactory.getInstance();
+SeedWalletGenerationResult seedWalletGenerationResult = walletFactory.randomWallet(true);
+```
+
+<!-- MULTICODE_BLOCK_END -->
+
+
+## Connect
+
+To make queries and submit transactions, you need to establish a connection to the XRP Ledger. 
+
+## Query
+
+## Submit transaction
+
+## Verify results
+
+
+
+
diff --git a/dactyl-config.yml b/dactyl-config.yml
index 474695359d..c91fda6f4d 100644
--- a/dactyl-config.yml
+++ b/dactyl-config.yml
@@ -1580,6 +1580,18 @@ pages:
         targets:
             - ja
 
+    -   md: tutorials/get-started/get-started-build-apps.md
+        html: get-started-build-apps.html
+        funnel: Build
+        doc_type: Tutorials
+        category: Get Started
+        template: template-doc.html
+        blurb: Learn the patterns to use when building apps on the XRP Ledger.
+        filters:
+            - js_editor
+        targets:
+            - en
+
     -   md: tutorials/get-started/get-started-with-the-rippled-api.md
         html: get-started-with-the-rippled-api.html
         funnel: Build