Skip to content

feat(PE-8620): add hosting unstoppable apps guides series #58

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 14 commits into
base: main
Choose a base branch
from
Open

feat(PE-8620): add hosting unstoppable apps guides series #58

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
20f5213
adding content plan
Oct 29, 2025
b770490
hosting unstoppable apps index page
Oct 29, 2025
371e87d
hosting a blog
Oct 29, 2025
77786bc
small fixes on structure
Oct 29, 2025
d137ef1
arweave/ao dapp
Oct 30, 2025
9a0919d
evm dapp
Oct 30, 2025
019bcf8
undernames for versioning
Oct 30, 2025
90cd584
arlink and ardrive
Oct 30, 2025
7b46942
finishing touches
Oct 30, 2025
3cffed8
fixing errors
Oct 30, 2025
f7e03bb
adding arlink images
Oct 30, 2025
01a9503
resvoling merge conflicts
Nov 4, 2025
3df6a8d
removing hosting apps plan
Nov 4, 2025
9f06812
Merge branch 'main' into feat-hosting-unstoppable-apps
dtfiedler Nov 7, 2025
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
fixing errors
  • Loading branch information
William Kempster committed Oct 30, 2025
commit 3cffed84d15c6d9b33a45066f50aec7a69cd9698
39 changes: 6 additions & 33 deletions content/build/access/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,48 +12,21 @@ Once data is stored on Arweave, it's permanently available. Here's how to access
Different methods serve different needs. Each provides unique capabilities for retrieving data from Arweave.

<Cards>
<Card
<Card
title="Find Data"
description={
<>
<p className="mb-3">Search and discover data on Arweave</p>
<div className="space-y-1 text-sm">
<div className="flex items-center gap-2"><Search className="w-4 h-4" /> Query by tags and metadata</div>
<div className="flex items-center gap-2"><Search className="w-4 h-4" /> Filter by app, owner, timestamp</div>
<div className="flex items-center gap-2"><Search className="w-4 h-4" /> Get transaction IDs for fetching</div>
</div>
</>
}
description="Search and discover data on Arweave. Query by tags and metadata, filter by app/owner/timestamp, and get transaction IDs for fetching."
href="/build/access/find-data"
icon={<Search className="w-8 h-8" />}
/>
<Card
<Card
title="Fetch Data"
description={
<>
<p className="mb-3">Retrieve data bytes from Arweave</p>
<div className="space-y-1 text-sm">
<div className="flex items-center gap-2"><Globe className="w-4 h-4" /> REST API endpoints</div>
<div className="flex items-center gap-2"><Globe className="w-4 h-4" /> GET arweave.net/[txId]</div>
<div className="flex items-center gap-2"><Globe className="w-4 h-4" /> Returns raw data/files</div>
</div>
</>
}
description="Retrieve data bytes from Arweave using REST API endpoints. Access via GET arweave.net/[txId] to get raw data and files."
href="/build/access/fetch-data"
icon={<Globe className="w-8 h-8" />}
/>
<Card
<Card
title="ArNS Names"
description={
<>
<p className="mb-3">Assign names to data and apps</p>
<div className="space-y-1 text-sm">
<div className="flex items-center gap-2"><Link className="w-4 h-4" /> Create names like ardrive.ar.io</div>
<div className="flex items-center gap-2"><Link className="w-4 h-4" /> Point to any Arweave data</div>
<div className="flex items-center gap-2"><Link className="w-4 h-4" /> Update targets as needed</div>
</div>
</>
}
description="Assign names to data and apps. Create names like ardrive.ar.io, point to any Arweave data, and update targets as needed."
href="/build/access/arns"
icon={<Link className="w-8 h-8" />}
/>
Expand Down
26 changes: 2 additions & 24 deletions content/build/guides/hosting-unstoppable-apps/deploying-with-arlink.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -204,34 +204,12 @@ Choose the right tool for your use case:
<Card
icon={<Zap />}
title="Use Arlink When..."
description={
<>
<ul>
<li>You prefer visual interfaces over command-line tools</li>
<li>Your build output is under 10MB</li>
<li>You want automated GitHub deployments</li>
<li>You need quick, one-off deployments</li>
<li>You want to use free Arlink undernames</li>
<li>Your build completes in under 10 minutes</li>
</ul>
</>
}
description="You prefer visual interfaces over command-line tools, your build output is under 10MB, you want automated GitHub deployments, you need quick one-off deployments, you want to use free Arlink undernames, or your build completes in under 10 minutes."
/>
<Card
icon={<FileCode />}
title="Use CLI When..."
description={
<>
<ul>
<li>Your build output exceeds 10MB</li>
<li>You need custom deployment scripts</li>
<li>You want CI/CD pipeline integration</li>
<li>You need Ethereum wallet deployment</li>
<li>You require Base-ETH payment options</li>
<li>You want full control over deployment process</li>
</ul>
</>
}
description="Your build output exceeds 10MB, you need custom deployment scripts, you want CI/CD pipeline integration, you need Ethereum wallet deployment, you require Base-ETH payment options, or you want full control over deployment process."
/>
</Cards>

Expand Down
78 changes: 6 additions & 72 deletions content/build/guides/hosting-unstoppable-apps/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,103 +44,37 @@ In this guide series, you will learn how to deploy static websites, blogs, Arwea
<Cards>
<Card
title="Hosting a Blog"
description={
<>
<p className="mb-3">
Learn the fundamentals of permanent web hosting by deploying a blog
</p>
<div className="space-y-1 text-sm">
<div>• Static site generator setup</div>
<div>• permaweb-deploy CLI walkthrough</div>
<div>• GitHub Actions automation</div>
</div>
</>
}
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"
description={
<>
<p className="mb-3">
Deploy decentralized applications built for the Arweave ecosystem
</p>
<div className="space-y-1 text-sm">
<div>• Wallet integration (ArConnect)</div>
<div>• AO process interaction</div>
<div>• Complete token dashboard example</div>
</div>
</>
}
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"
description={
<>
<p className="mb-3">
Create permanent frontends for Ethereum and EVM-compatible dApps
</p>
<div className="space-y-1 text-sm">
<div>• Web3 wallet integration (wagmi)</div>
<div>• Smart contract interactions</div>
<div>• Multi-chain support</div>
</div>
</>
}
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" />}
/>
<Card
title="Using Undernames for Versioning"
description={
<>
<p className="mb-3">
Manage multiple versions and environments with ArNS undernames
</p>
<div className="space-y-1 text-sm">
<div>• Dev/staging/production workflows</div>
<div>• Blue-green deployments</div>
<div>• Programmatic undername management</div>
</div>
</>
}
description="Manage multiple versions and environments with ArNS undernames. Learn dev/staging/production workflows, blue-green deployments, and programmatic undername management."
href="/build/guides/hosting-unstoppable-apps/using-undernames-for-versioning"
icon={<GitBranch className="w-6 h-6" />}
/>
<Card
title="Deploying with Arlink"
description={
<>
<p className="mb-3">
One-click deployments using the Arlink web interface
</p>
<div className="space-y-1 text-sm">
<div>• Visual deployment workflow</div>
<div>• No CLI required</div>
<div>• Automatic build detection</div>
</div>
</>
}
description="One-click deployments using the Arlink web interface. Features visual deployment workflow, no CLI required, and automatic build detection."
href="/build/guides/hosting-unstoppable-apps/deploying-with-arlink"
icon={<Zap className="w-6 h-6" />}
/>
<Card
title="Deploying with ArDrive"
description={
<>
<p className="mb-3">
Deploy permanent dApps using ArDrive's user-friendly web interface
</p>
<div className="space-y-1 text-sm">
<div>• Drag-and-drop folder uploads</div>
<div>• Automatic manifest creation</div>
<div>• Integrated ArNS assignment</div>
</div>
</>
}
description="Deploy permanent dApps using ArDrive's user-friendly web interface. Includes drag-and-drop folder uploads, automatic manifest creation, and integrated ArNS assignment."
href="/build/guides/hosting-unstoppable-apps/hosting-with-ardrive"
icon={<Upload className="w-6 h-6" />}
/>
Expand Down
39 changes: 6 additions & 33 deletions content/build/run-a-gateway/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,48 +12,21 @@ Join the decentralized network that powers permanent data access. Run your own *
Choose the deployment approach that fits your needs - from local testing to production infrastructure.

<Cards>
<Card
<Card
title={<span className="flex items-center gap-2">Production Gateway <span className="text-xs bg-green-500/10 text-green-600 dark:text-green-400 px-2 py-1 rounded-full">Earn Rewards</span></span>}
description={
<>
<p className="mb-3">Join the AR.IO Network and earn ARIO tokens</p>
<div className="space-y-1 text-sm">
<div className="flex items-center gap-2"><DollarSign className="w-4 h-4" /> Earn ARIO token rewards</div>
<div className="flex items-center gap-2"><Network className="w-4 h-4" /> Serve Wayfinder traffic</div>
<div className="flex items-center gap-2"><Server className="w-4 h-4" /> Cache and serve Arweave data</div>
</div>
</>
}
description="Join the AR.IO Network and earn ARIO tokens. Earn rewards by serving Wayfinder traffic and caching/serving Arweave data."
href="/build/run-a-gateway/quick-start#production-setup-with-custom-domain"
icon={<Server className="w-6 h-6" />}
/>
<Card
<Card
title="Local Gateway"
description={
<>
<p className="mb-3">Perfect for development and testing</p>
<div className="space-y-1 text-sm">
<div className="flex items-center gap-2"><Check className="w-4 h-4" /> Quick Docker setup</div>
<div className="flex items-center gap-2"><Check className="w-4 h-4" /> Test gateway features</div>
<div className="flex items-center gap-2"><Check className="w-4 h-4" /> No commitment required</div>
</div>
</>
}
description="Perfect for development and testing. Features quick Docker setup, ability to test gateway features, and no commitment required."
href="/build/run-a-gateway/quick-start"
icon={<Terminal className="w-6 h-6" />}
/>
<Card
<Card
title="Custom Configuration"
description={
<>
<p className="mb-3">Optimize for specific use cases</p>
<div className="space-y-1 text-sm text-muted-foreground">
<div>• Data filtering options</div>
<div>• Performance tuning</div>
<div>• Advanced features</div>
</div>
</>
}
description="Optimize for specific use cases. Includes data filtering options, performance tuning, and advanced features."
href="/build/run-a-gateway/manage/filters"
icon={<Database className="w-6 h-6" />}
/>
Expand Down
47 changes: 3 additions & 44 deletions content/build/upload/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,60 +32,19 @@ There are multiple ways to upload data to Arweave. Each has its own attributes a
</span>
</span>
}
description={
<>
<p className="mb-3">
Production-ready bundling service with enterprise features
</p>
<div className="space-y-1 text-sm">
<div className="flex items-center gap-2">
<CreditCard className="w-4 h-4" /> Credit cards, AR, ETH, SOL, MATIC
</div>
<div className="flex items-center gap-2">
<Zap className="w-4 h-4" /> Free uploads under 100 KiB
</div>
<div className="flex items-center gap-2">
<Shield className="w-4 h-4" /> Automatic retry & confirmation
</div>
</div>
</>
}
description="Production-ready bundling service with enterprise features. Accepts credit cards, AR, ETH, SOL, MATIC. Free uploads under 100 KiB with automatic retry and confirmation."
href="/build/upload/bundling-services"
icon={<Image src="/turbo.svg" alt="Turbo" width={40} height={40} />}
/>
<Card
title="ArDrive"
description={
<>
<p className="mb-3">No-code solution for personal and business files</p>
<div className="space-y-1 text-sm">
<div className="flex items-center gap-2">
<Check className="w-4 h-4" /> Drag-and-drop interface
</div>
<div className="flex items-center gap-2">
<Check className="w-4 h-4" /> End-to-end encryption
</div>
<div className="flex items-center gap-2">
<Check className="w-4 h-4" /> Powered by Turbo
</div>
</div>
</>
}
description="No-code solution for personal and business files. Features drag-and-drop interface, end-to-end encryption, and powered by Turbo."
href="https://app.ardrive.io"
icon={<Image src="/ardrive.svg" alt="ArDrive" width={40} height={40} />}
/>
<Card
title="Direct to Arweave"
description={
<>
<p className="mb-3">Raw protocol access for advanced use cases</p>
<div className="space-y-1 text-sm text-muted-foreground">
<div>• AR tokens required</div>
<div>• Manual transaction handling</div>
<div>• Complex setup needed</div>
</div>
</>
}
description="Raw protocol access for advanced use cases. Requires AR tokens, manual transaction handling, and complex setup."
href="https://arweave.org"
icon={<Image src="/arweave.png" alt="Arweave" width={40} height={40} />}
/>
Expand Down
3 changes: 2 additions & 1 deletion src/lib/source.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ export const source = loader({
// Handle custom SVG/PNG icons
if (typeof icon === 'string' && (icon.endsWith('.svg') || icon.endsWith('.png'))) {
return createElement(Image, {
key: icon,
src: icon,
alt: '',
width: 16,
Expand All @@ -30,6 +31,6 @@ export const source = loader({
}

// Handle lucide-react icons
if (icon in icons) return createElement(icons[icon as keyof typeof icons]);
if (icon in icons) return createElement(icons[icon as keyof typeof icons], { key: icon });
},
});