This comprehensive validation guide ensures your Ring Platform installation is working correctly. Follow each step systematically to verify all core features before proceeding with customization or deployment.
10-15 minutes to complete all validation steps.
Before starting validation, ensure:
npm run dev should show "Ready - started server on 0.0.0.0:3000".env.local contains all required keysThis comprehensive validation guide ensures your Ring Platform installation is working correctly. Follow each step systematically to verify all core features before proceeding with customization or deployment.
10-15 minutes to complete all validation steps.
Before starting validation, ensure:
npm run dev should show "Ready - started server on 0.0.0.0:3000".env.local contains all required keysThis comprehensive validation guide ensures your Ring Platform installation is working correctly. Follow each step systematically to verify all core features before proceeding with customization or deployment.
10-15 minutes to complete all validation steps.
Before starting validation, ensure:
npm run dev should show "Ready - started server on 0.0.0.0:3000".env.local contains all required keysGoal: Verify the application starts correctly and serves the homepage.
In your Ring Platform directory
Expected output:
▲ Next.js 15.x.x
- Local: http://localhost:3000
- Environments: .env.local
- Ready - started server on 0.0.0.0:3000
❌ Common Issues:
lsof -ti:3000 | xargs killnpm install to install dependencies.env.localTest HTTP response
Expected: HTTP/1.1 200 OK
Test page content
Expected: HTML content with Ring Platform branding
http://localhost:3000 in your browserGoal: Verify Auth.js v5 setup and OAuth providers work correctly.
Visit http://localhost:3000/login
Expected:
Validation Commands: Test OAuth callback endpoint Expected: HTTP/1.1 302 Found (redirect)
API Test: Test session endpoint
Expected Response:
/profile or /[locale]/profileGoal: Verify database operations work correctly.
Test health endpoint
Expected Response:
Create Test Entity:
http://localhost:3000/entitiesAPI Validation: List entities Expected: Array of entities or empty array
PostgreSQL Test: Direct database test (if using local PostgreSQL) Expected: Count >= 1 (your user account)
Firebase Test (if using Firebase): Test Firestore connection Expected: Success message
Goal: Validate opportunities, messaging, and real-time features.
http://localhost:3000/opportunitiesAPI Test: Test opportunities endpoint
Expected: Array of opportunities or empty array
WebSocket Test: Test tunnel transport endpoint
Notification Test:
Goal: Validate blockchain integration and wallet functionality.
/profile or /walletAPI Test: Test wallet endpoint Expected: Wallet balance information
Goal: Verify the application starts correctly and serves the homepage.
In your Ring Platform directory
Expected output:
▲ Next.js 15.x.x
- Local: http://localhost:3000
- Environments: .env.local
- Ready - started server on 0.0.0.0:3000
❌ Common Issues:
lsof -ti:3000 | xargs killnpm install to install dependencies.env.localTest HTTP response
Expected: HTTP/1.1 200 OK
Test page content
Expected: HTML content with Ring Platform branding
http://localhost:3000 in your browserGoal: Verify Auth.js v5 setup and OAuth providers work correctly.
Visit http://localhost:3000/login
Expected:
Validation Commands: Test OAuth callback endpoint Expected: HTTP/1.1 302 Found (redirect)
API Test: Test session endpoint
Expected Response:
/profile or /[locale]/profileGoal: Verify database operations work correctly.
Test health endpoint
Expected Response:
Create Test Entity:
http://localhost:3000/entitiesAPI Validation: List entities Expected: Array of entities or empty array
PostgreSQL Test: Direct database test (if using local PostgreSQL) Expected: Count >= 1 (your user account)
Firebase Test (if using Firebase): Test Firestore connection Expected: Success message
Goal: Validate opportunities, messaging, and real-time features.
http://localhost:3000/opportunitiesAPI Test: Test opportunities endpoint
Expected: Array of opportunities or empty array
WebSocket Test: Test tunnel transport endpoint
Notification Test:
Goal: Validate blockchain integration and wallet functionality.
/profile or /walletAPI Test: Test wallet endpoint Expected: Wallet balance information
Goal: Verify the application starts correctly and serves the homepage.
In your Ring Platform directory
Expected output:
▲ Next.js 15.x.x
- Local: http://localhost:3000
- Environments: .env.local
- Ready - started server on 0.0.0.0:3000
❌ Common Issues:
lsof -ti:3000 | xargs killnpm install to install dependencies.env.localTest HTTP response
Expected: HTTP/1.1 200 OK
Test page content
Expected: HTML content with Ring Platform branding
http://localhost:3000 in your browserGoal: Verify Auth.js v5 setup and OAuth providers work correctly.
Visit http://localhost:3000/login
Expected:
Validation Commands: Test OAuth callback endpoint Expected: HTTP/1.1 302 Found (redirect)
API Test: Test session endpoint
Expected Response:
/profile or /[locale]/profileGoal: Verify database operations work correctly.
Test health endpoint
Expected Response:
Create Test Entity:
http://localhost:3000/entitiesAPI Validation: List entities Expected: Array of entities or empty array
PostgreSQL Test: Direct database test (if using local PostgreSQL) Expected: Count >= 1 (your user account)
Firebase Test (if using Firebase): Test Firestore connection Expected: Success message
Goal: Validate opportunities, messaging, and real-time features.
http://localhost:3000/opportunitiesAPI Test: Test opportunities endpoint
Expected: Array of opportunities or empty array
WebSocket Test: Test tunnel transport endpoint
Notification Test:
Goal: Validate blockchain integration and wallet functionality.
/profile or /walletAPI Test: Test wallet endpoint Expected: Wallet balance information
Test response times
Test response times
Test response times
Create curl-format.txt:
Create curl-format.txt:
Create curl-format.txt:
time_namelookup: %{time_namelookup}\n
time_connect: %{time_connect}\n
time_appconnect: %{time_appconnect}\n
time_pretransfer: %{time_pretransfer}\n
time_redirect: %{time_redirect}\n
time_starttransfer: %{time_starttransfer}\n
----------\n
time_total: %{time_total}\n
time_namelookup: %{time_namelookup}\n
time_connect: %{time_connect}\n
time_appconnect: %{time_appconnect}\n
time_pretransfer: %{time_pretransfer}\n
time_redirect: %{time_redirect}\n
time_starttransfer: %{time_starttransfer}\n
----------\n
time_total: %{time_total}\n
time_namelookup: %{time_namelookup}\n
time_connect: %{time_connect}\n
time_appconnect: %{time_appconnect}\n
time_pretransfer: %{time_pretransfer}\n
time_redirect: %{time_redirect}\n
time_starttransfer: %{time_starttransfer}\n
----------\n
time_total: %{time_total}\n
Expected: Total time < 2 seconds
Expected: Total time < 2 seconds
Expected: Total time < 2 seconds
Simple load test
Simple load test
Simple load test
Expected: All requests return 200 OK
Expected: All requests return 200 OK
Expected: All requests return 200 OK
Test 404 handling Expected: 404 Not Found Test API error handling Expected: Proper error response
Test 404 handling Expected: 404 Not Found Test API error handling Expected: Proper error response
Test 404 handling Expected: 404 Not Found Test API error handling Expected: Proper error response
"Sign in failed" or OAuth errors:
"Sign in failed" or OAuth errors:
"Sign in failed" or OAuth errors:
.env.local credentials format.env.local credentials format.env.local credentials formatSession not persisting:
Session not persisting:
Session not persisting:
AUTH_SECRET is set (32+ characters)AUTH_SECRET is set (32+ characters)AUTH_SECRET is set (32+ characters)"Database connection failed": PostgreSQL Test connection
"Database connection failed": PostgreSQL Test connection
"Database connection failed": PostgreSQL Test connection
Firebase connection issues: Check Firebase config
Firebase connection issues: Check Firebase config
Firebase connection issues: Check Firebase config
"API endpoint not found":
"API endpoint not found":
"API endpoint not found":
CORS errors:
CORS errors:
CORS errors:
NEXTAUTH_URL matches your domainNEXTAUTH_URL matches your domainNEXTAUTH_URL matches your domainWebSocket not connecting:
WebSocket not connecting:
WebSocket not connecting:
Notifications not appearing:
Notifications not appearing:
Notifications not appearing:
Slow page loads: Check bundle size Profile with browser dev tools Network tab: Check for large assets Performance tab: Record and analyze
Slow page loads: Check bundle size Profile with browser dev tools Network tab: Check for large assets Performance tab: Record and analyze
Slow page loads: Check bundle size Profile with browser dev tools Network tab: Check for large assets Performance tab: Record and analyze
Memory issues: Monitor Node.js process Or use PM2: pm2 monit
Memory issues: Monitor Node.js process Or use PM2: pm2 monit
Memory issues: Monitor Node.js process Or use PM2: pm2 monit
| Component | Status | Notes |
|---|---|---|
| Application Startup | ☐ | Server starts, homepage loads |
| Authentication | ☐ | Google OAuth works, sessions persist |
| Database | ☐ | Connections work, data operations succeed |
| Entities | ☐ | CRUD operations function correctly |
| Opportunities | ☐ | Listing, creation, search works |
| Real-time | ☐ | WebSocket connections, notifications |
| Wallet | ☐ | Address creation, balance display |
| Component | Status | Notes |
|---|---|---|
| Application Startup | ☐ | Server starts, homepage loads |
| Authentication | ☐ | Google OAuth works, sessions persist |
| Database | ☐ | Connections work, data operations succeed |
| Entities | ☐ | CRUD operations function correctly |
| Opportunities | ☐ | Listing, creation, search works |
| Real-time | ☐ | WebSocket connections, notifications |
| Wallet | ☐ | Address creation, balance display |
| Component | Status | Notes |
|---|---|---|
| Application Startup | ☐ | Server starts, homepage loads |
| Authentication | ☐ | Google OAuth works, sessions persist |
| Database | ☐ | Connections work, data operations succeed |
| Entities | ☐ | CRUD operations function correctly |
| Opportunities | ☐ | Listing, creation, search works |
| Real-time | ☐ | WebSocket connections, notifications |
| Wallet | ☐ | Address creation, balance display |
✅ FULL SUCCESS - All checkboxes above are checked
✅ FULL SUCCESS - All checkboxes above are checked
✅ FULL SUCCESS - All checkboxes above are checked
⚠️ PARTIAL SUCCESS - 70%+ of features work
⚠️ PARTIAL SUCCESS - 70%+ of features work
⚠️ PARTIAL SUCCESS - 70%+ of features work
❌ NEEDS ATTENTION - < 70% functional
❌ NEEDS ATTENTION - < 70% functional
❌ NEEDS ATTENTION - < 70% functional
Congratulations! Your Ring Platform installation is fully functional. You're now ready to:
Need help customizing? Check our white-label guide for advanced customization options.
Congratulations! Your Ring Platform installation is fully functional. You're now ready to:
Need help customizing? Check our white-label guide for advanced customization options.
Congratulations! Your Ring Platform installation is fully functional. You're now ready to:
Need help customizing? Check our white-label guide for advanced customization options.
Having issues? Check our troubleshooting guide or join our Discord community for support.
Having issues? Check our troubleshooting guide or join our Discord community for support.
Having issues? Check our troubleshooting guide or join our Discord community for support.
| API Health |
| API Health |
| API Health |
| ☐ |
| ☐ |
| ☐ |
| All endpoints respond correctly |
| All endpoints respond correctly |
| All endpoints respond correctly |
| Performance | ☐ | Response times < 2s |
| Performance | ☐ | Response times < 2s |
| Performance | ☐ | Response times < 2s |
| Error Handling | ☐ | Proper error responses |
| Error Handling | ☐ | Proper error responses |
| Error Handling | ☐ | Proper error responses |