Get started with Alternate Futures in minutes:

# Install the CLI
npm install -g @alternatefutures/cli

# Login to your account
af auth login

# Deploy your first site
af sites deploy

npm i -g @alternatefutures/cli

npm i @alternatefutures/sdk

Our repositories are organized by type for easy discovery:

Backend services and APIs that power the platform.

• service-auth - Multi-method authentication (Email, SMS, Web3, OAuth)
• service-cloud-api - GraphQL API backend with Prisma + YugibyteDB

Published npm packages for developers.

• package-cloud-cli - Command-line deployment tool
• package-cloud-sdk - JavaScript/TypeScript SDK

Quick-start templates for popular frameworks.

• template-cloud-nextjs - Next.js → IPFS/Arweave
• template-cloud-react - React SPA template
• template-cloud-astro - Astro static sites
• template-cloud-vue - Vue.js applications
• template-cloud-hugo - Hugo static sites

Framework-specific integrations.

• adapter-cloud-next - Next.js adapter for Alternate Futures Cloud

Our websites and applications.

• web-alternatefutures.ai - Company website
• web-app.alternatefutures.ai - Dashboard application
• web-docs.alternatefutures.ai - Documentation site

Deploy to IPFS, Arweave, Filecoin, and Akash Network for censorship-resistant, permanent hosting.

Run on decentralized compute infrastructure for a fraction of traditional cloud costs.

Built from the ground up with Web3 primitives - wallets, DePIN, permanent storage.

Simple CLI, comprehensive SDK, and GraphQL API make integration effortless.

For Users:

• Visit alternatefutures.ai
• Try the Web App
• Read the Docs

For Developers:

• Install the CLI
• Use the SDK
• Fork a Template

For Contributors:

• Check our open issues
• Read the contributing guide in this repo which setup rules for all repos
• Read the contributing guides in each repo
• Join our Discord

# Install CLI
npm install -g @alternatefutures/cli

# Initialize a new project
af sites init

# Deploy to IPFS
af sites deploy

# Add a custom domain
af domains add example.com

Clone a template to get started quickly:

# Next.js
npx create-af-app my-app --template nextjs

# React
npx create-af-app my-app --template react

# Astro
npx create-af-app my-app --template astro

Our platform is built with modern, production-ready technologies:

• Frontend: SvelteKit, Next.js, TypeScript, Material UI
• Backend: GraphQL Yoga, Prisma, PostgreSQL, Redis
• Authentication: JWT, OAuth2, SIWE (Sign-In with Ethereum)
• Storage: IPFS, Arweave, Filecoin, Lighthouse
• Compute: Akash Network, Cloudflare Workers
• DevOps: Docker, GitHub Actions, ArgoCD

We welcome contributions from developers of all skill levels!

1. Find an Issue

   • Browse open issues
   • Look for good first issue labels
   • Check individual repo contribution guides

2. Fork & Clone

   • Fork the repository you want to contribute to
   • Clone it locally and create a feature branch

3. Make Changes

   • Follow the code style of the project
   • Add tests if applicable
   • Update documentation

4. Submit PR

   • Push your changes and create a Pull Request
   • Describe your changes clearly
   • Link related issues

• Follow conventional commits (feat:, fix:, docs:, etc.)
• Write clear, concise commit messages
• Add tests for new features
• Update documentation as needed
• Be respectful and collaborative

• Platform Docs - Complete platform documentation
• CLI Docs - CLI command reference
• SDK Docs - SDK API documentation
• API Docs - GraphQL API reference

• Quick Start - Get started in 5 minutes
• Deployment Guide - Deploy your first site
• Custom Domains - Add your own domain
• AI Agents - Deploy autonomous agents

• Technical Architecture Map - Complete system architecture with Mermaid diagrams
• Overview - Platform architecture
• DePIN Integration - Decentralized infrastructure
• Security - Security best practices

Join our growing community of developers building on decentralized infrastructure:

• Discord - Chat with the team and community
• Twitter - Follow for updates
• Blog - Read our latest posts
• Newsletter - Get monthly updates

All repositories in this organization are licensed under the MIT License unless otherwise specified.

See individual repositories for specific license information.