My First NFT Guide Update #838

tippi-fifestarr · 2025-02-28T23:16:59Z

Description

This PR reorganizes Your First NFT into a more streamlined, tutorial-style page. Key changes include:

Step-by-step flow: Converted to a single, cohesive “Steps” tutorial with clear headings and callouts.

Single TypeScript example: Consolidated the instructions into one TS project for easier setup and execution, removing Python snippets from the main guide.

Overall walkthrough: We explain the code before presenting the step by step how to do it and example code.

Readability and structure: Added environment variable configuration, tsconfig.json setup, code explanations, and direct links to the Aptos Explorer to simplify the user onboarding experience.

Should help our developers go faster 🚀

Checklist

If any existing pages were renamed or removed:
- Were redirects added to next.config.mjs?
- Did you update any relative links that pointed to the renamed / removed pages?
Do all Lints pass?
- Have you ran pnpm fmt?
- Have you ran pnpm lint?

vercel · 2025-02-28T23:17:03Z

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
developer-docs-nextra	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Mar 14, 2025 10:59pm

apps/nextra/pages/en/build/guides/your-first-nft.mdx

hariria · 2025-03-01T00:50:29Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx

+1. Create a new file called `index.ts` in your project folder:

-To read a token's metadata:
-
-```python filename="example.py"
-async def get_token_data(
-    token_client: AptosTokenClient, token_addr: AccountAddress
-) -> dict[str, str]:
-    token = (await token_client.read_object(token_addr)).resources[Token]
-    return {
-        "collection": str(token.collection),
-        "description": str(token.description),
-        "name": str(token.name),
-        "uri": str(token.uri),
-        "index": str(token.index),
-    }
+```bash filename="Terminal"
+touch index.ts
 ```

-  </Tabs.Tab>
-</Tabs>
+<Callout type="info">
+**Windows users:** Use `type nul > index.ts` in Command Prompt.
+</Callout>


Can we use Tabs here? one for mac / linux and another for windows?

Great idea, I've just updated and replaced three sections with the Tabs component:

In the "Create tsconfig.json" section

In the "Configure Environment Variables" section

In the "Adding index.ts" section

hariria · 2025-03-01T00:50:52Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx

+<Callout type="warning">
+Remember to save your file after adding the configuration!
+</Callout>


Nit: Remove

We did a couple user interviews and found that several folks we interviewed forgot to save and ended up confused, so that's what inspired that callout. I think it's worth keeping in the "Your First NFT" especially since NFT creators aren't necessarily technical, but may be using AI to help them get by (meaning when they miss small steps like this it's hard for them to notice why if they've already refocused on another file).

hariria · 2025-03-01T00:51:24Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx

+1. Create a new TypeScript configuration file:

-const committedTxn = await aptos.signAndSubmitTransaction({
-  signer: alice,
-  transaction: mintTokenTransaction,
-});
+```bash filename="Terminal"
+touch tsconfig.json
 ```


Can we use Tabs here, one tab for mac os / linux and another for windows?

Yes, thank you

hariria · 2025-03-01T00:52:42Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx

+- **Collection Creation**: A "collection" is a grouping of digital assets. We'll create a new collection under Alice's account.
+- **Minting a Digital Asset**: Once the collection is in place, we'll mint a new digital asset (NFT) under that collection.
+- **Transferring a Digital Asset**: Finally, we'll transfer the newly minted asset from Alice to Bob.


Nit: remove these steps are mentioned above already, repetitive to have both

Thanks Co-authored-by: Andrew Hariri <hariria@usc.edu>

Co-authored-by: Andrew Hariri <hariria@usc.edu>

tippi-fifestarr · 2025-03-13T17:55:15Z

Andrew, I've reviewed this once more and think I've resolved everything @hariria, can you take another look?

hariria · 2025-03-13T20:40:38Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx


---
+**Congrats!**


Lol maybe let's remove, looks strange

hariria · 2025-03-13T20:42:13Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx

+1. Create a `.env` file by running:

-<Tabs items={["TypeScript", "Python"]}>
+<Tabs items={["Mac/Linux", "Windows"]}>
  <Tabs.Tab>
-
-```ts filename="example.ts"
-await aptos.fundAccount({
-  accountAddress: alice.accountAddress,
-  amount: 100_000_000,
-});
-await aptos.faucet.fundAccount({
-  accountAddress: bob.accountAddress,
-  amount: 100_000_000,
-});
-```
-
+    ```bash filename="Terminal"
+    touch .env
+    ```
  </Tabs.Tab>
  <Tabs.Tab>
-
-```python filename="example.py"
-bob_fund = faucet_client.fund_account(alice.address(), 100_000_000)
-alice_fund = faucet_client.fund_account(bob.address(), 100_000_000)
-```
-
+    ```bash filename="Terminal"
+    type nul > .env
+    ```


Can we skip this? I think we should assume that the user knows how to make a new file on their machine. Ideally it just looks like "Create a .env file with the following:"

hariria · 2025-03-13T20:43:44Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx

+1. Create a new TypeScript configuration file:

-<Tabs items={["TypeScript", "Python"]}>
+<Tabs items={["Mac/Linux", "Windows"]}>
  <Tabs.Tab>
-
-```ts filename="example.ts"
-const alice = Account.generate();
-const bob = Account.generate();
-```
-
+    ```bash filename="Terminal"
+    touch tsconfig.json
+    ```
  </Tabs.Tab>
  <Tabs.Tab>
-
-```python filename="example.py"
-alice = Account.generate()
-bob = Account.generate()
-```
-
+    ```bash filename="Terminal"
+    type nul > tsconfig.json
+    ```
  </Tabs.Tab>
 </Tabs>

-<Callout type="info">
-Note that this only generates the local keypair. After generating the keypair and public address, the account still does not exist on-chain.
+2. Open the `tsconfig.json` file and add the following configuration:


Can we skip this? I think we should assume that the user knows how to make a new file on their machine. Ideally it just looks like "Create a tsconfig file with the following:"

I also removed the Tabs from "create index.ts file" as well.

hariria · 2025-03-13T20:44:07Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx

+<Callout type="warning">
+Remember to save your file after adding the configuration!
 </Callout>


This also seems extraneous

hariria · 2025-03-13T20:44:39Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx

+<Callout type="warning">
+Remember to save your `.env` file after adding the configuration!
+</Callout>


Nit: Extraneous

…create files

hariria

Almost there, a couple nits

apps/nextra/pages/en/build/guides/your-first-nft.mdx

hariria · 2025-03-13T23:39:07Z

apps/nextra/pages/en/build/guides/your-first-nft.mdx


-Each object created from the `aptos_token.move` contract is a distinct asset. The assets owned by a user are stored separately from the user's account. To check if a user owns an object, check the object's owner:
+- **Node.js**: Make sure you have Node.js (version 16 or later) and npm installed.
+- **Aptos CLI (Optional)**: Having the [Aptos CLI](https://aptos.dev/cli-tools/aptos-cli-tool/install-aptos-cli) can be helpful if you want to inspect on-chain data directly, but it's not required for this tutorial.


removed the prerequisites section 👍

Co-authored-by: Andrew Hariri <hariria@usc.edu>

first draft of update, tested

c45f53d

tippi-fifestarr requested review from gregnazario and hariria as code owners February 28, 2025 23:17

vercel bot deployed to Preview February 28, 2025 23:21 View deployment

hariria requested changes Mar 1, 2025

View reviewed changes

tippi-fifestarr and others added 4 commits March 4, 2025 15:49

3 intro fixes, thanks andrew

22dabe5

Merge branch 'aptos-labs:main' into my-first-nft-pr

fb88fb1

Andrew fix

b4233dd

Thanks Co-authored-by: Andrew Hariri <hariria@usc.edu>

TS link more concise

a9f9262

Co-authored-by: Andrew Hariri <hariria@usc.edu>

vercel bot deployed to Preview March 4, 2025 22:01 View deployment

more fixes from andrew

641af14

vercel bot deployed to Preview March 4, 2025 22:19 View deployment

tippi-fifestarr added 2 commits March 6, 2025 16:30

allow user to select operating system to see relevant terminal commands

ad4d20c

removed redundant Key Steps section

c06613e

vercel bot deployed to Preview March 6, 2025 22:40 View deployment

found and cleaned up two .mdx links at the end

8887f89

vercel bot deployed to Preview March 13, 2025 17:55 View deployment

hariria reviewed Mar 13, 2025

View reviewed changes

removed extra callouts about saving files and instructions on how to …

53400aa

…create files

vercel bot deployed to Preview March 13, 2025 22:36 View deployment

tippi-fifestarr requested a review from hariria March 13, 2025 22:46

hariria approved these changes Mar 13, 2025

View reviewed changes

tippi-fifestarr and others added 3 commits March 14, 2025 17:46

Update apps/nextra/pages/en/build/guides/your-first-nft.mdx

24461e2

Co-authored-by: Andrew Hariri <hariria@usc.edu>

rm prerequisites

751ffb7

Merge branch 'main' into my-first-nft-pr

b80880f

vercel bot deployed to Preview March 14, 2025 22:59 View deployment

tippi-fifestarr merged commit 3a17d18 into aptos-labs:main Mar 15, 2025
4 of 5 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

My First NFT Guide Update #838

My First NFT Guide Update #838

tippi-fifestarr commented Feb 28, 2025

vercel bot commented Feb 28, 2025 •

edited

Loading

hariria Mar 1, 2025

tippi-fifestarr Mar 6, 2025

hariria Mar 1, 2025

jmintuitive Mar 6, 2025

hariria Mar 1, 2025

tippi-fifestarr Mar 6, 2025

hariria Mar 1, 2025

tippi-fifestarr Mar 6, 2025

tippi-fifestarr commented Mar 13, 2025

hariria Mar 13, 2025

hariria Mar 13, 2025

hariria Mar 13, 2025

tippi-fifestarr Mar 13, 2025

hariria Mar 13, 2025

hariria Mar 13, 2025

tippi-fifestarr Mar 13, 2025

hariria left a comment

hariria Mar 13, 2025

tippi-fifestarr Mar 14, 2025


		---
		Congrats!

My First NFT Guide Update #838

My First NFT Guide Update #838

Conversation

tippi-fifestarr commented Feb 28, 2025

Description

Checklist

vercel bot commented Feb 28, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

tippi-fifestarr commented Mar 13, 2025

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

hariria left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

vercel bot commented Feb 28, 2025 •

edited

Loading