๐Ÿ“– Aptos Developer Documentation

July 23, 2025 ยท View on GitHub

Documentation has moved to the new aptos-docs repository.

This repository is now archived and will not receive updates.

Aptos Developer Docs

Website Docs Discord X (Twitter) GitHub Issues

With results visible at: https://github.com/aptos-labs/developer-docs/actions/workflows/links.yml


๐Ÿ“– Aptos Developer Documentation

Official Aptos developer documentation, providing everything you need to set up, develop, and test your projects.

๐Ÿ“Œ Table of Contents

๐Ÿ“Œ For additional instructions, see the README.md inside apps/nextra/.

Aptos uses lychee-broken-link-checker to verify broken links in Markdown files.

Results can be viewed here:
๐Ÿ”— GitHub Actions: Link Checking


๐Ÿ’ป Installation

โš™๏ธ Requirements

Before you proceed, ensure you have installed the following dependencies:

  • Node.js
    ๐Ÿ“Œ Install via Homebrew:

    brew install node
    
  • pnpm (package manager)
    ๐Ÿ“Œ Install the latest version:

    curl -fsSL https://get.pnpm.io/install.sh | sh -
    

๐Ÿ“‚ Clone the Repository

git clone https://github.com/aptos-labs/developer-docs.git

๐Ÿ“ฆ Install Dependencies

๐Ÿ“Œ If you are using macOS M1 Sonoma or later, first run:

pnpm add node-gyp -g

๐Ÿ“Œ Then install all dependencies:

pnpm install

๐Ÿš€ Develop on Nextra

โš  Important: For more details, see apps/nextra/README.md.

1๏ธโƒฃ Set up the environment

๐Ÿ“Œ Ensure your .env is properly configured inside apps/nextra/.env.
Use .env.example as a template.

๐Ÿ“Œ Validate the setup:

pnpm prebuild

2๏ธโƒฃ Build Nextra

pnpm run build

๐Ÿ“Œ This command builds apps/nextra and all dependent local packages.

3๏ธโƒฃ Navigate to the subdirectory

cd apps/nextra

4๏ธโƒฃ Run the local development server

pnpm run dev

๐Ÿ“Œ Server will be available at:
๐Ÿ”— http://localhost:3000


๐Ÿž Debugging

๐Ÿ“Œ Fix formatting issues by running:

pnpm fmt

๐Ÿ”„ Regenerating Contributors

๐Ÿ“Œ The src/contributors.json file (which powers the author list at the bottom of doc pages) needs manual updates.

1๏ธโƒฃ Authenticate with GitHub

๐Ÿ“Œ Install GitHub CLI:
๐Ÿ”— Installation Guide

๐Ÿ“Œ Log into your GitHub account:

gh auth login --scopes read:user,user:email

2๏ธโƒฃ Generate the contributor list

pnpm contributors

๐Ÿ“Œ The updated list will now appear in the documentation.


Website Docs Discord X (Twitter) GitHub Discussions


๐Ÿ“œ License

This project is licensed under the Apache 2.0.
See LICENSE for more details.


๐Ÿค Contributors

A huge thank you to everyone who has contributed to this project! ๐Ÿ™Œ