🚀 One-Click Deploy — Barbrick Design Setup Wizard

Step 1 — Highest Impact

Railway Backend Variables

Your Railway backend is the backbone for 80+ features. Setting these environment variables unlocks payments, AI, email, and more instantly.

🚂

Configure Railway Environment Variables

Required for: payments, AI features, email notifications, WebSocket gateway, GitHub integration

Go to railway.app/dashboard and sign in (or create a free account)
Create a new project and deploy from GitHub — connect your forked repository
Click the deployed service → Variables in the left sidebar
Add GATEWAY_TOKEN — generate a strong 32-char secret: generate-secret.vercel.app/32
Add all HIGH-priority variables from the table below
Click Deploy — wait for the green "Active" status in Railway
Visit https://your-service.up.railway.app/api/health — confirm {"ok":true}
Connect your dashboard: open user-dashboard.html → Settings → Quick Connect → enter wss://your-service.up.railway.app + GATEWAY_TOKEN

Variable Name	Where to Get It / Value	Priority
PAYPAL_CLIENT_ID	PayPal Developer → My Apps → Live → Client ID	HIGH
PAYPAL_SECRET	PayPal Developer → My Apps → Live → Secret key	HIGH
PAYPAL_WEBHOOK_ID	PayPal Developer → Webhooks → copy Webhook ID for your endpoint URL	HIGH
PAYPAL_MODE	Set to `production` for live payments, or `sandbox` for testing	HIGH
PAYPAL_EMAIL	Your PayPal business email address	HIGH
GATEWAY_TOKEN	A strong secret string (32+ chars) — used for WebSocket dashboard connection	HIGH
AGENTR	Your GitHub Personal Access Token (see Step 5)	HIGH
OPENAI_API_KEY	platform.openai.com/api-keys	MED
GOOGLE_CLIENT_ID	Google Cloud Console → OAuth 2.0 Client ID (see Step 3)	MED
ROOTIBAPP_CLIENT_ID	GitHub OAuth App Client ID → github.com/settings/developers	MED
ROOTIBAPP_CLIENT_SECRET	Same GitHub OAuth App — Client Secret	MED
EMAIL_USER	Your Gmail address for outgoing notifications	MED
EMAIL_PASS	Gmail App Password — myaccount.google.com/apppasswords	MED
SOLANA_RPC_URL	Helius RPC URL — helius.dev (free plan available)	MED
TWILIO_ACCOUNT_SID	console.twilio.com — for SMS features	LOW
TWILIO_AUTH_TOKEN	Twilio Console → Account Info	LOW
TWILIO_PHONE	Your Twilio phone number (e.g. `+15551234567`)	LOW
GROQ_API_KEY	console.groq.com/keys — free tier	LOW
XAI_API_KEY	x.ai/api — Grok API	LOW
AGENT_PASSCODE	Any secure password for admin agent control endpoints	LOW
GOOGLE_MAPS_API_KEY	Google Cloud Console → Maps JavaScript API key (see Step 8)	LOW

⚠️ After adding variables, Railway restarts the service automatically. Check the deployment logs to confirm it starts successfully.

Step 3

Google OAuth Setup

17+ programs use Google Sign-In. Setting this up once unlocks all of them simultaneously.

🔑

Create a Google OAuth 2.0 Client

Required for: agentHub, JeZues, JeEeZues, explorer, casinoAi, autoRips, tRiniTy, trinityLoop, and 9 more

Go to console.cloud.google.com and create or select a project
Navigate to APIs & Services → Credentials
Click + Create Credentials → OAuth 2.0 Client ID → Application type: Web application
Under Authorized JavaScript origins, add your domain:
https://YOUR-GITHUB-USERNAME.github.io
and http://localhost:3000 for local development
Click Create → copy the Client ID
Add to Railway as GOOGLE_CLIENT_ID = your Client ID
Also add the Client ID to js/site-config.js in your repository:
window.GOOGLE_CLIENT_ID = "YOUR_CLIENT_ID_HERE";
Enable the OAuth consent screen — set app name, user support email, and add your domain to authorized domains

ℹ️ Without Google OAuth, affected programs run in "Demo Mode". They are still usable — Google Sign-In is an enhancement, not a blocker for core functionality.

Step 4

Phantom Wallet (Solana)

13 programs use Phantom for Solana transactions. No server-side setup is needed — users install the browser extension.

👻

Phantom Wallet — User Setup Instructions

Affected programs: 2024, 2042, 2042cc, 2042ccArt, 420, cc2024, ccArtHolo, BloomersHub, enhancedPiSOL, PiSOL

Install Phantom Wallet from phantom.app (Chrome, Firefox, or Safari extension)
Create a new Solana wallet or import an existing one using your seed phrase
Fund the wallet with SOL if needed for transactions (mainnet programs)
Visit any Solana-enabled program — it will detect Phantom and show a "Connect Wallet" button automatically

✅ The CCART 3D card programs work fully without Phantom. Wallet is only needed for the optional "Sign with wallet" blockchain feature.

⚡

Include User Wallet Setup in Your Deployment (TODO for you)

Add this onboarding notice to your deployment's welcome page or README

Add a "Get Started with Solana" section to your index.html or user onboarding page linking to phantom.app
Optionally embed the Phantom install detection snippet from js/universal-wallet-system.js to auto-prompt wallet installation

Step 6

OpenAI / AI API Keys

Several programs use AI features. Groq is free and fastest to set up. OpenAI unlocks GPT-4 features.

🤖

Set Up AI API Keys in Railway

Required for: autoRips, trendSmith, aiSchool, MERLIN_P5_CONTROL_PANEL, GGE AI features

Groq (free & fast): Go to console.groq.com/keys → Create API Key → Add to Railway as GROQ_API_KEY
OpenAI: Go to platform.openai.com/api-keys → Create new secret key → Add to Railway as OPENAI_API_KEY
xAI / Grok (optional): Go to x.ai/api → Get API key → Add to Railway as XAI_API_KEY
The backend uses keys in priority order: xAI → Groq → OpenAI. You only need one to get started.
For autoRips.html: after setting OPENAI_API_KEY in Railway, the page auto-fetches it via /config — or enter it manually in the page settings panel
Verify: visit https://YOUR-SERVICE.up.railway.app/api/ai/status — confirm at least one AI key is active

💡 Groq is recommended for getting started — it's free, fast, and requires no billing setup. Add OpenAI later for GPT-4 access.

Step 7

Solana / Pump.fun Integration

22 programs use Solana features. Most work as-is with Phantom wallet, but a faster RPC endpoint improves reliability.

⚡

Solana RPC Endpoint (recommended)

Improves: enhancedPiSOL, PiSOL, account.html, admin-forge.html, wallet programs

Sign up at helius.dev (free plan available)
Create an API key and copy your Mainnet RPC URL
Add to Railway Variables:
SOLANA_RPC_URL = https://mainnet.helius-rpc.com/?api-key=YOUR_KEY
All Solana programs will automatically use the faster RPC endpoint from the backend /config

🪙

Pump.fun Ecosystem — Already Configured

Pump.fun referral and vault wallet are pre-configured in src/systems/pumpfun-ecosystem-config.js

Confirm src/systems/pumpfun-ecosystem-config.js exists in your deployment
Verify referral URL is accessible: https://refer.pump.fun/DiamondBoi
(Optional) Update the vault wallet address in pumpfun-ecosystem-config.js to your own Solana wallet if you want to receive vault contributions

✅ Pump.fun integration is pre-configured. No additional setup required unless you want to change the vault wallet.

🎉

Your Platform is Ready!

You've completed all the gateway configuration steps. Your Barbrick Design platform should now be fully operational.

🔍 Final Verification Checklist

Visit https://YOUR-SERVICE.up.railway.app/api/health → {"ok":true}
Visit https://YOUR-SERVICE.up.railway.app/api/paypal/status → "configured":true
Visit https://YOUR-SERVICE.up.railway.app/scan/status → "auth":true
Open user-dashboard.html → connect to Railway WebSocket → see green "Connected" status
Open contributor-dashboard-hub.html → verify contributor registration form loads
Test a small payment via PayPal sandbox mode to confirm end-to-end payment flow

🖥️ User Dashboard 👥 Contributor Dashboard 🛠️ Full Setup Guide ⚙️ Admin Dashboard 🏠 Back to Hub 📧 Contact Support

⚠️ Support: If you encounter issues, email BarbrickDesign@gmail.com with your Railway service URL and a description of the problem.

Go to Hub →

Deploy Your Barbrick Design Platform

Configure Railway Environment Variables

Create a Live PayPal App & Get Credentials

Create a Google OAuth 2.0 Client

Phantom Wallet — User Setup Instructions

Include User Wallet Setup in Your Deployment (TODO for you)

Create a GitHub Personal Access Token

Create a GitHub OAuth App (for dashboard login)

Set Up AI API Keys in Railway

Solana RPC Endpoint (recommended)

Pump.fun Ecosystem — Already Configured

Google Maps API

Twilio SMS (optional)

Microphone / Hardware Requirements

Gmail App Password (for Email Notifications)

Your Platform is Ready!

🔍 Final Verification Checklist