https://github.com/aptos-labs/aptos-docs
Documentation for the Aptos Blockchain
https://github.com/aptos-labs/aptos-docs
aptos aptos-move blockchain docs documentation
Last synced: 3 months ago
JSON representation
Documentation for the Aptos Blockchain
- Host: GitHub
- URL: https://github.com/aptos-labs/aptos-docs
- Owner: aptos-labs
- License: apache-2.0
- Created: 2025-02-02T17:19:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-09T04:25:51.000Z (3 months ago)
- Last Synced: 2026-03-09T09:31:46.558Z (3 months ago)
- Topics: aptos, aptos-move, blockchain, docs, documentation
- Language: MDX
- Homepage: https://aptos.dev
- Size: 19.2 MB
- Stars: 52
- Watchers: 1
- Forks: 26
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 
Aptos Docs
This repository contains the source code for the official Aptos Developer Documentation, built using [Astro](https://astro.build/) and [Starlight](https://starlight.astro.build/).
## Quick Start
```bash
# Clone the repository
git clone https://github.com/aptos-labs/aptos-docs.git
cd aptos-docs
# Install dependencies
pnpm install
# Set up environment variables
cp .env.example .env
# Start the development server
pnpm dev
```
Visit `http://localhost:4321` to see the documentation running locally.
## Editing Documentation
The main documentation content is located in the `src/content/docs/` directory:
- Content is organized in directories that match the URL structure
- Files are written in Markdown MDX (`.mdx`) format
- Each file begins with frontmatter (metadata between `---` delimiters)
Example frontmatter:
```yaml
---
title: Your Page Title
description: A brief description of the page content
---
```
For more resources on authoring content within this environment, see:
- [Authoring Content in Markdown](https://starlight.astro.build/guides/authoring-content/)
- [Using Components](https://starlight.astro.build/components/using-components/)
With the development server running (`pnpm dev`), your changes will be reflected immediately.
## Prerequisites
- **Node.js:** Version 22.x (specified in `.nvmrc`, use [nvm](https://github.com/nvm-sh/nvm))
- **pnpm:** Version 10.2.0 or higher (`npm install -g pnpm`)
- **Git:** For cloning the repository
## Key Features
- Multi-language support
- Interactive components (GraphiQL editor, Testnet Faucet)
- API Reference via OpenAPI specifications
- Move Reference documentation
- Search functionality (Algolia DocSearch)
- Dynamic OG Images
## Common Commands
| Command | Description |
| -------------- | ----------------------------- |
| `pnpm dev` | Start the development server |
| `pnpm build` | Build the site for production |
| `pnpm preview` | Preview the production build |
| `pnpm lint` | Check for linting issues |
| `pnpm format` | Fix formatting issues |
## Environment Variables
Key environment variables:
| Variable | Type | Purpose | Required? |
| ----------------------- | ------ | ------------------------------ | ------------------------------------ |
| `GITHUB_TOKEN` | Secret | Fetching Move Reference docs | Only if `ENABLE_MOVE_REFERENCE=true` |
| `ENABLE_API_REFERENCE` | Public | Build REST API reference pages | Optional (default: `false`) |
| `ENABLE_MOVE_REFERENCE` | Public | Build Move Reference docs | Optional (default: `false`) |
| Firebase Credentials | Public | Authentication features | Required for Faucet/Auth |
| Algolia Credentials | Public | Documentation search | Optional |
| `GTAG_ID` | Public | Google Analytics tracking | Optional |
| `OG_IMAGES_SECRET` | Secret | Dynamic OG image generation | Recommended for Vercel |
## Project Structure
```
.
├── config/ # Global sidebar configuration helper
├── patches/ # Patched npm dependencies
├── public/ # Static assets
├── scripts/ # Utility scripts (Migration & Middleware generation)
├── src/
│ ├── assets/ # Site assets
│ ├── components/ # Reusable components
│ ├── config/ # Configuration helpers (i18n, docSearch, sidebar)
│ ├── content/ # Content Collections
│ │ ├── docs/ # Main documentation content
│ │ ├── i18n/ # UI translations
│ │ └── nav/ # Sidebar translations
│ ├── integrations/ # Custom integrations
│ ├── lib/ # Utility functions
│ ├── loaders/ # Content Collection loaders
│ ├── middlewares/ # Edge Middleware
│ ├── pages/ # Astro pages
│ ├── plugins/ # Remark/Rehype plugins
│ ├── starlight-overrides/ # Overridden components
│ ├── stores/ # State management
│ ├── styles/ # CSS styles
│ └── utils/ # General utilities
└── Various config files # Configuration files
```
## Configuration Files
| File | Purpose |
| ------------------ | --------------------------------------------- |
| `.env.example` | Example environment variables |
| `astro.config.mjs` | Main configuration |
| `astro.sidebar.ts` | Documentation sidebar structure |
| `package.json` | Project dependencies and scripts |
| `vercel.json` | Vercel deployment configuration and redirects |
## Redirects
Redirects are handled in `./vercel.json` for optimal performance. This approach ensures redirects are processed at the CDN level before middleware logic runs, providing faster response times for users and less potential for conflicts.
The `vercel.json` file contains all URL redirects with the following structure:
```json
{
"redirects": [
{
"source": "/old-path",
"destination": "/new-path",
"permanent": true
}
]
}
```
**Benefits of CDN-level redirects:**
- **Performance**: Redirects are handled at the edge, closest to users
- **Speed**: No server-side processing or middleware execution required
- **Efficiency**: Bypasses i18n middleware and other application logic
- **Reliability**: Reduces server load and potential points of failure
When adding new redirects, always update the `vercel.json` file rather than implementing them in middleware to maintain optimal performance.
For more information on configuring redirects, see the [Vercel redirects documentation](https://vercel.com/docs/project-configuration#redirects).
## Technologies Used
| Category | Technology | Description |
| ------------------- | --------------------------------------------------- | ------------------------------------------ |
| **Framework** | [Astro](https://astro.build/) | Web framework for content-driven sites |
| **Docs Framework** | [Starlight](https://starlight.astro.build/) | Documentation toolkit for Astro |
| **Styling** | [Tailwind CSS](https://tailwindcss.com/) | Utility-first CSS framework |
| **UI Components** | [React](https://react.dev/) | UI library (via Astro Islands) |
| **Package Manager** | [pnpm](https://pnpm.io/) | Fast, disk space efficient package manager |
| **Search** | [Algolia DocSearch](https://docsearch.algolia.com/) | Documentation search |
| **Authentication** | [Firebase](https://firebase.google.com/) | Auth and backend services |
| **Deployment** | [Vercel](https://vercel.com/) | Hosting platform |
## Contributing
- Ensure code adheres to ESLint rules (`pnpm lint`)
- Format code using Prettier (`pnpm format`)