Skip to content

Repository files navigation

Vertex ⚡

Professional Crypto Invoicing on Solana

Solana Next.js Supabase Vercel

Get paid instantly. Vertex is a simple, professional invoicing tool designed for the Solana freelance economy. It lets freelancers generate professional agreements and get paid in USDC or SOL directly to their wallets.

Launch Live App 🚀


Vertex Landing Page

🎯 Vision

Vertex solves the fragmentation in the Solana freelance economy. We replace clunky manual transfers with a streamlined, professional invoicing flow that settles instantly on-chain.

✨ Core Features

  • ⚡ Instant Settlement: Generate wallet-signed invoices that pay directly to your wallet.
  • 🔗 Smart Payment Links: Direct, cryptographic links for SOL, USDC, or USDT.
  • 📜 Agreement Drafting: Formal service agreements that transition seamlessly into invoices.
  • 🔍 Precision Verification: Automated server-side transaction signature verification.
  • 📊 Business Dashboard: Institutional-grade tracking of recent invoices, clients, and payment status.
  • 🛡️ High-Agency Trust: Separate wallet connection and Supabase session management for maximum security.

🛠️ Tech Stack

Layer Technology
Framework Next.js 16 (App Router)
Styling Tailwind CSS v4, Framer Motion (Spring Physics)
Blockchain @solana/web3.js, @solana/wallet-adapter
Backend Supabase (Postgres + RLS + Service Role Verification)
Documents jsPDF, jspdf-autotable, docx
Infrastructure Vercel

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • Solana Wallet (Phantom, Solflare, etc.)
  • Supabase Project

Installation

git clone https://github.com/Ghostiemoh/vertex.git
cd vertex
npm install
cp .env.example .env.local

Environment Setup

Variable Description
NEXT_PUBLIC_SUPABASE_URL Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEY Supabase anon key
SUPABASE_SERVICE_ROLE_KEY Required for server-side verification
NEXT_PUBLIC_SOLANA_NETWORK devnet or mainnet-beta
NEXT_PUBLIC_SITE_URL https://vertex-pay.vercel.app

Database Initialization

  1. Execute the SQL schema in your Supabase SQL Editor: src/lib/schema.sql.
  2. Enable Solana Web3 auth in Supabase settings if required.

Development

npm run dev

🏗️ Architecture

  • State Management: Optimized for high-intensity UI components with Framer Motion.
  • Security Protocols: Narrow server routes for public payment links; explicit UI labeling for Sandbox (Devnet) vs Production (Mainnet).
  • Asset Integrity: PDF generation with verification hashes embedded for audit trails.

Roadmap


Built with precision on Solana.

About

Crypto invoicing for the Solana freelance economy. Generate professional agreements and get paid in USDC or SOL straight to your wallet.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages