๐ 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.
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
- ๐ป Installation
- ๐ Clone the Repository
- ๐ฆ Install Dependencies
- ๐ Develop on Nextra
- ๐ Debugging
- ๐ Regenerating Contributors
๐ For additional instructions, see the
README.mdinsideapps/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.
๐ Useful Links
๐ 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! ๐