Solstice Protocol Website

Official landing page and web application for Solstice Protocol - Zero-Knowledge Identity Verification on Solana.

Overview

This repository contains the frontend website that connects to the Solstice Protocol backend and circuits for zero-knowledge identity verification.

Architecture

┌─────────────────────────────────────────────────────────┐
│                    Solstice Ecosystem                    │
├─────────────────────────────────────────────────────────┤
│                                                           │
│  SolsticeProtocol (Main Repo)      solstice-website     │
│  ┌─────────────────────┐           ┌──────────────────┐ │
│  │ Backend (Express)   │◄──────────┤ Frontend (React) │ │
│  │ - API Server        │   HTTP    │ - Landing Page   │ │
│  │ - Database          │           │ - Web App        │ │
│  │ - Auth System       │           │ - ZK UI          │ │
│  └─────────────────────┘           └──────────────────┘ │
│           ▲                                  │           │
│           │                                  │           │
│           ▼                                  ▼           │
│  ┌─────────────────────┐           ┌──────────────────┐ │
│  │ Circuits (Circom)   │───────────►│ Public Circuits  │ │
│  │ - age_proof         │   Copied   │ (WASM + Keys)    │ │
│  │ - nationality_proof │           └──────────────────┘ │
│  │ - uniqueness_proof  │                                │
│  └─────────────────────┘                                │
│           ▲                                              │
│           │                                              │
│           ▼                                              │
│  ┌─────────────────────┐                                │
│  │ Solana Contracts    │                                │
│  │ (Anchor/Rust)       │                                │
│  └─────────────────────┘                                │
│                                                           │
└─────────────────────────────────────────────────────────┘

Quick Start

Prerequisites

• Node.js 18+ and npm
• Access to SolsticeProtocol repository (backend & circuits)
• Solana wallet browser extension (Phantom recommended)

Installation

1. Install frontend dependencies:

cd frontend
npm install

2. Sync circuits from SolsticeProtocol:

# From solstice-website root directory
./sync-circuits.sh

3. Configure environment:

cd frontend
cp .env.example .env
# Edit .env with your settings

4. Start development server:

npm run dev

Visit http://localhost:5173

Running Full Stack

Terminal 1 - Backend:

cd ../SolsticeProtocol/backend
npm install
npm run dev  # Runs on port 3000

Terminal 2 - Frontend:

cd solstice-website/frontend
npm run dev  # Runs on port 5173

See INTEGRATION.md for detailed setup.

Tech Stack

• React 19, TypeScript, Vite, Tailwind CSS
• snarkjs (ZK proofs), Solana Web3.js
• Custom fonts: Advercase & Nighty

Documentation

• INTEGRATION.md - Full integration guide
• frontend/LANDING_PAGE.md - Landing page docs
• frontend/FONT_SETUP.md - Font setup

License

MIT