Synapsis is an open-source, federated social network built to serve as global communication infrastructure. It is designed to be lightweight, easy to deploy, and interoperable with the broader fediverse.

Features

Federation Ready: Built with ActivityPub compatibility in mind (WebFinger, NodeInfo).
Identity: Portable identity system backed by user handles.
Modern UI: Clean, responsive interface inspired by Vercel's design system.
Rich Media: Support for image uploads and media galleries.
Moderation: Built-in admin dashboard for user management and content moderation.
Setup Wizard: User-friendly /install flow to get your node running in minutes.
Curated Feeds: Smart feed algorithms to highlight engaging content.

Tech Stack

Framework: Next.js 15+ (App Router)
Database: PostgreSQL (via Neon / Drizzle ORM)
Styling: Tailwind CSS v4 & custom Vercel-like design system
Authentication: Auth.js (NextAuth)
Type Safety: TypeScript

Installation & Setup

You can run Synapsis locally for development or deploy it to a VPS for production.

Prerequisites

Node.js 18+
PostgreSQL database (e.g., Neon or self-hosted)
Domain name (for production)

1. Clone & Install

git clone https://github.com/cyph3rasi/Synapsis.git
cd Synapsis
npm install

2. Configure Environment

Copy the example configuration:

cp .env.example .env

Edit .env with your credentials:

# Database
DATABASE_URL="postgresql://user:password@host/dbname..."

# Auth (Generate with: openssl rand -base64 33)
AUTH_SECRET="your-secret-key"

# Node Info
NEXT_PUBLIC_NODE_DOMAIN="localhost:3000" # Use your domain for production
NEXT_PUBLIC_NODE_NAME="My Synapsis Node"

# Admin Access
ADMIN_EMAILS="admin@example.com"

3. Initialize Database

npm run db:push

4. Run the Application

For Local Development:

npm run dev
# Visit http://localhost:3000

For Production (VPS): We recommend using PM2 to run the app in the background.

# Build the project
npm run build

# Install PM2
sudo npm install -g pm2

# Start the app
pm2 start npm --name "synapsis" -- start
pm2 save
pm2 startup

5. Production Reverse Proxy (Optional)

For production, use Nginx to handle SSL and forward traffic to port 3000.

server {
    server_name your-domain.com;
    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
    }
}

Updates

To update your node:

git pull origin main
npm install
npm run build
pm2 restart synapsis

License

Licensed under the Apache 2.0 License. See LICENSE for details.