Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
adding arlink images
  • Loading branch information
William Kempster committed Oct 30, 2025
commit f7e03bb0d753c263a39700f0693c0b02dde3f3f6
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Deploying with Arlink
title: One Click Deployments with Arlink
description: Learn how to deploy unstoppable applications to Arweave using Arlink's visual web interface with automated builds and ArNS integration.
---

Expand All @@ -8,9 +8,10 @@ import { Card, Cards } from 'fumadocs-ui/components/card';
import { Steps, Step } from 'fumadocs-ui/components/steps';
import { Zap, Github, Globe, Sparkles, FileCode, Rocket, GitBranch } from 'lucide-react';

![Arlink login page showing GitHub, Wander, and MetaMask authentication options](/arlink-homepage.png)
## Introduction

Arlink provides a visual, web-based platform for deploying applications to Arweave without using command-line tools. It offers automated builds, GitHub integration, and seamless ArNS management through an intuitive interface.
[Arlink](https://arlink.ar.io) provides a visual, web-based platform for deploying applications to Arweave without using command-line tools. It offers automated builds, GitHub integration, and seamless ArNS management through an intuitive interface.

<Callout title="New to unstoppable apps?" type="info">
Check out the [series introduction](/build/guides/hosting-unstoppable-apps) to understand how AR.IO Network makes apps truly unstoppable with 100+ independent gateways.
Expand All @@ -36,6 +37,8 @@ Arlink is a web-based deployment platform that simplifies hosting applications o
- **Real-Time Monitoring** - Live build logs and progress tracking
- **ArNS Management** - Connect existing ArNS names or use free Arlink undernames



<Callout type="info" title="CLI vs Web Interface">
All applications that can be deployed with `permaweb-deploy` CLI can also be deployed with Arlink. Choose the tool that fits your workflow:
- **Arlink**: Visual workflows, quick deployments, smaller projects (under 10MB)
Expand Down Expand Up @@ -74,9 +77,7 @@ The deployment process consists of four main phases. For detailed step-by-step i

Navigate to the [Arlink Dashboard](https://arlink.arweave.net/) and connect your Arweave wallet (Wander). Then authorize GitHub access to enable repository connections.

{/* Screenshot: Arlink dashboard with "Connect Wallet" button highlighted */}

{/* Screenshot: GitHub authorization page showing permissions requested by Arlink */}
![Arlink login page showing GitHub, Wander, and MetaMask authentication options](/arlink-login.png)

<Callout type="info">
Arlink only requests read access to your repositories and webhook permissions for continuous deployment.
Expand All @@ -91,7 +92,7 @@ Select your GitHub repository and branch. Arlink will automatically detect:
- **Build Command** - Usually `npm run build`
- **Output Directory** - `dist/`, `build/`, `out/`, etc.

{/* Screenshot: Repository selection interface with detected build settings */}
![Arlink repository selection interface showing GitHub repositories with import buttons](/arlink-repo-select.png)

Review the auto-detected settings and adjust if needed. Ensure your output directory matches your framework:

Expand All @@ -102,6 +103,8 @@ Review the auto-detected settings and adjust if needed. Ensure your output direc
| Astro | `dist/` | Static by default |
| Create React App | `build/` | Default configuration |

![Arlink deploy configuration options](/arlink-deploy-config.png)

### 3. Choose Domain

Select how your application will be accessible:
Expand All @@ -122,7 +125,7 @@ Select how your application will be accessible:

Click **Deploy** to start the build process. Arlink will clone your repository, install dependencies, build your application, and upload to Arweave.

{/* Screenshot: Build progress view with live logs and status indicators */}
![Arlink deployment build monitoring](/arlink-deployment-process.png)

**Build Timeline:**
- Small apps (~1MB): 2-3 minutes
Expand All @@ -133,6 +136,7 @@ Click **Deploy** to start the build process. Arlink will clone your repository,
Arlink enforces a **10MB max build output** and **10-minute build timeout**. For larger applications, use `permaweb-deploy` CLI instead.
</Callout>


Once complete, your application is permanently deployed and accessible via:
- Your chosen domain (e.g., `myapp_arlink.arweave.net`)
- Any AR.IO gateway (e.g., `myapp_arlink.g8way.io`)
Expand Down Expand Up @@ -171,7 +175,7 @@ Undernames use underscore separators: `staging_myapp` not `staging.myapp`. See [

The Arlink dashboard lets you view deployment history, manage undernames, and rollback to previous deployments by updating which transaction ID your ArNS name points to.

{/* Screenshot: Arlink dashboard showing deployment history and rollback options */}
![Arlink deployment build monitoring](/arlink-history.png)

## Limitations & Considerations

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Hosting a Blog on Arweave Name System (ArNS)"
title: "Hosting a Blog on ArNS"
description: "Learn how to deploy a permanent, censorship-resistant blog to Arweave with ArNS using permaweb-deploy"
---

Expand Down
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

recommend whittling this down to just arweave with maybe a turbo sdk example instead of AO.

Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Hosting an Arweave/AO dApp"
title: "Hosting an Arweave/AO App on ArNS"
description: "Learn how to build and deploy decentralized applications that interact with Arweave and AO processes"
---

Expand Down
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For simplicity, recommend using rainbowkit or thirdweb for wallet connection and hooks. Wagmi, viem, react query integrate seemlessly with that.

Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Hosting an EVM dApp on ArNS"
title: "Hosting an EVM App on ArNS"
description: "Deploy an Ethereum dApp frontend to Arweave with ArNS integration, combining EVM smart contracts with permanent decentralized hosting"
---

Expand Down
6 changes: 3 additions & 3 deletions content/build/guides/hosting-unstoppable-apps/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,19 +43,19 @@ In this guide series, you will learn how to deploy static websites, blogs, Arwea

<Cards>
<Card
title="Hosting a Blog"
title="Hosting a Blog on ArNS"
description="Learn the fundamentals of permanent web hosting by deploying a blog. Covers static site generator setup, permaweb-deploy CLI walkthrough, and GitHub Actions automation."
href="/build/guides/hosting-unstoppable-apps/hosting-a-blog"
icon={<BookOpen className="w-6 h-6" />}
/>
<Card
title="Hosting Arweave/AO dApp"
title="Hosting an Arweave/AO App on ArNS"
description="Deploy decentralized applications built for the Arweave ecosystem. Includes wallet integration (ArConnect), AO process interaction, and a complete token dashboard example."
href="/build/guides/hosting-unstoppable-apps/hosting-arweave-ao-dapp"
icon={<Code className="w-6 h-6" />}
/>
<Card
title="Hosting EVM dApp"
title="Hosting an EVM App on ArNS"
description="Create permanent frontends for Ethereum and EVM-compatible dApps. Features Web3 wallet integration (wagmi), smart contract interactions, and multi-chain support."
href="/build/guides/hosting-unstoppable-apps/hosting-evm-dapp"
icon={<Rocket className="w-6 h-6" />}
Expand Down
Binary file added public/arlink-deploy-config.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/arlink-deployment-process.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/arlink-history.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/arlink-homepage.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/arlink-login.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/arlink-repo-select.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.