Skip to content

Conversation

@kempsterrrr
Copy link
Collaborator

Add Comprehensive Guide Series: Hosting Unstoppable Apps

This PR introduces a complete guide series for deploying
applications on Arweave with ArNS integration, replacing the
previous single-page guide with 6 comprehensive, hands-on
tutorials.

What's New

New Guide Series (content/build/guides/hosting-unstoppable-apps/)

  1. Hosting a Blog - Foundational deployment with Next.js and Astro
  2. Hosting Arweave/AO dApp - ARIO Token Dashboard with AO process
    integration
  3. Hosting EVM dApp - ETH Wallet Dashboard with custom wagmi UI
  4. Using Undernames for Versioning - Practical versioning patterns
    and GitHub Actions
  5. Deploying with Arlink - Visual deployment with GitHub
    integration
  6. Deploying with ArDrive - Drag-and-drop web interface deployment

Key Improvements

  • Comprehensive Coverage: Tools include permaweb-deploy CLI,
    Arlink, and ArDrive Web
  • Practical Examples: Complete, runnable code with proper error
    handling
  • Consistent Standards: Uses fetch API, @ar.io/sdk, Fumadocs
    components throughout
  • Better Organization: Logical progression from simple to advanced
    deployment patterns

Changes Made

  • ✅ Created 6 new guides with consistent structure and styling
  • ✅ Added navigation structure and meta.json configuration
  • ✅ Updated 11 files with corrected internal links
  • ✅ Added 7 redirects for deprecated content
  • ✅ Removed 3 deprecated files:
    • hosting-decentralized-websites.mdx
    • working-with-arns/arns-undernames-versioning.mdx
    • deploy-dapp-with-ardrive-web.mdx
  • ✅ Build verified: 256 pages generated successfully

Migration Path

All old URLs redirect to appropriate new locations, ensuring no
broken links.

@atticusofsparta
Copy link
Contributor

need to resolve the conflicts here

@kempsterrrr
Copy link
Collaborator Author

I think these are handled now

@atticusofsparta atticusofsparta changed the title feat: add hosting unstoppable apps guides series feat(PE-8620): add hosting unstoppable apps guides series Nov 4, 2025
</Tab>
</Tabs>

### RSS Feed (Optional)
Copy link
Contributor

Choose a reason for hiding this comment

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

Lets outline here the difference between subscribing and publishing the RSS feed.

There should be one section on subscribing to an RSS feed and displaying it on the blog, and one for having other people integrate the blog into their RSS feed (not even sure its possible to publish rss feeds from arns, so check that. Its going to depend on arweave manifests).

Deploying a blog to Arweave creates a **permanent, censorship-resistant website** that will be accessible forever through the AR.IO Network's 100+ independent gateways. Unlike traditional hosting where your content can disappear if you stop paying or if the host shuts down, content on Arweave is stored permanently for a one-time fee.

This guide will teach you how to:
- Set up a static blog with Next.js or Astro
Copy link
Contributor

Choose a reason for hiding this comment

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

Lets make sure astro works here and ideally link to an example project configured properly

Copy link
Contributor

Choose a reason for hiding this comment

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

Should have the same linking and insurance on the nextjs side

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.

}
```

## Configuring Vite for SPA Routing
Copy link
Contributor

Choose a reason for hiding this comment

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

We should add the node polyfills plugin here to avoid possible confusion.

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.

<Tabs items={['Vite', 'Next.js']}>
<Tab value="Vite">

### Create Web3 Configuration
Copy link
Contributor

Choose a reason for hiding this comment

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

recommend we link out for these sorts of configurations to prevent stale docs.

<Tabs items={['Vite', 'Next.js']}>
<Tab value="Vite">

### Configure Vite
Copy link
Contributor

Choose a reason for hiding this comment

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

should probably include polyfills plugin

const packageJson = require('../package.json');

// Get version from package.json (e.g., "2.1.0")
const version = packageJson.version.replace(/\./g, '-'); // "2-1-0"
Copy link
Contributor

Choose a reason for hiding this comment

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

Recommend adding a comment here on valid undernames. If for example they have a version like 1.0.0@alpha-1 or something, the @ is invalid.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants