> docs --help

Documentation

Everything you need to deploy on-chain with Solinx

Introduction

Solinx is a decentralized deployment platform that enables you to deploy web applications to the blockchain. Deploy once, live forever on ICP (Internet Computer Protocol), Base, and IPFS.

Key Features

  • Indestructible hosting - Distributed across IPFS with no single point of failure
  • GitHub integration - Connect your repo and deploy in seconds
  • On-chain domains - Register and manage .base.eth domains
  • Real-time builds - Watch your deployments happen live via WebSocket
  • Free forever tier - 3 projects, unlimited bandwidth, no credit card required

Quick Start

Get your first project deployed in under 2 minutes.

$1. Sign in with GitHub
→ Visit /auth/login
$2. Create a new project
→ Connect your GitHub repository
$3. Deploy
→ Your site goes live on ICP + Base
Get StartedBrowse Templates

Authentication

Solinx supports multiple authentication methods for secure access.

GitHub OAuth

The recommended way to authenticate. Connect your GitHub account to access your repositories.

  1. Click "Login" in the navigation
  2. Select "Continue with GitHub"
  3. Authorize Solinx to access your repositories
  4. You'll be redirected back with your access token

Wallet Login

Connect with your Web3 wallet for a decentralized authentication experience.

Wallet login is available for users who prefer Web3-native authentication. You'll need to sign a message to verify wallet ownership.

Projects

Projects are the core of Solinx. Each project represents a deployment from a GitHub repository.

Creating a Project

  1. Navigate to Projects - Click "New Project" from your dashboard
  2. Select Repository - Choose from your connected GitHub repositories
  3. Choose Branch - Select the branch you want to deploy (default: main)
  4. Configure Project:
    • Project name (auto-generated from repo name)
    • Framework detection (auto-detected or manual)
    • Environment variables (optional)
  5. Deploy - Click "Deploy" to start the build process

Project Settings

Each project has its own settings page where you can:

  • Update project name and description
  • Manage environment variables
  • Configure build settings
  • Connect custom domains
  • View deployment history

Templates

Start with a pre-built template and deploy in 15 seconds. All templates are Base-native and deploy straight to ICP.

MiniSwap

DeFi

Uniswap V2 fork pre-connected to Base mainnet

NFT Drop

NFTs

Gasless mints, 1155 support, royalties

Onchain Game

Gaming

Fully on-chain game engine + leaderboard

Token Gated Site

Members-only

Only NFT holders can access

Perp DEX Dashboard

Trading

Live orderbook + positions on Base L2

AI Agent Frontend

AI

Chat with your on-chain agent

Browse All Templates

Builds & Deployments

Every deployment goes through a build process that compiles your code and deploys it to multiple networks.

Build Process

1

Clone Repository

Your GitHub repository is cloned to the build environment

2

Install Dependencies

Dependencies are installed using npm, pnpm, or yarn (auto-detected)

3

Build Project

Your project is built using the detected framework (Next.js, Vite, etc.)

4

Deploy to Networks

Your built files are deployed to IPFS, ICP, and Base simultaneously

Real-time Build Logs

Watch your builds happen in real-time via WebSocket connections. Build logs stream directly to your browser.

Deployment Networks

IPFS

Content-addressed storage for distributed hosting

ICP

Internet Computer Protocol for permanent hosting

Base

Base blockchain for identity and registry

Domains

Register and manage .base.eth domains for your deployments. Domains are truly yours on-chain.

Registering a Domain

  1. Navigate to the Domains page from your dashboard
  2. Enter your desired .base.eth domain name
  3. Check availability (domains are unique)
  4. Complete registration (free on Free tier, included with Pro)
  5. Link your domain to a project deployment

💡 Pro tip: Free tier includes basic .base.eth domains. Pro tier includes custom domains and advanced DNS settings.

Settings

Manage your account settings, integrations, and API tokens.

Profile

Update your profile information, email, and display preferences.

Integrations

Manage your GitHub connection and other third-party integrations.

API Tokens

Generate and manage API tokens for programmatic access to your projects.

Billing

View your subscription, payment methods, and billing history.

Pricing

Simple, transparent pricing. Start free, scale as you grow.

API Reference

Programmatic access to Solinx via REST API. All endpoints require authentication.

Authentication

Include your access token in the Authorization header:

Authorization: Bearer <your-access-token>

Projects

GET /api/projects
POST /api/projects
GET /api/projects/:id
PATCH /api/projects/:id
DELETE /api/projects/:id

Builds

GET /api/projects/:id/builds
POST /api/builds/start
GET /api/builds/:id

Deployments

GET /api/deployments
GET /api/deployments/:id

Troubleshooting

Build Failures

If your build fails, check the build logs for specific errors. Common issues:

  • Missing dependencies in package.json
  • Incorrect build command configuration
  • Environment variables not set
  • Framework detection issues

Deployment Issues

If your deployment doesn't appear:

  • Wait a few minutes for IPFS propagation
  • Check that your build completed successfully
  • Verify your domain configuration
  • Check deployment status in the dashboard

Authentication Problems

If you're having trouble logging in:

  • Clear your browser cache and cookies
  • Revoke and re-authorize GitHub access
  • Check that your access token hasn't expired
  • Try logging out and back in

Ready to deploy?

Start building on-chain with Solinx today.

Go to DashboardBrowse Templates