SAINT FRANCIS CLINIC

DEPLOYMENT & OPERATIONS DIAGNOSTIC SUITE

PRE-FLIGHT STAGE

Pre-flight Checklist

Production Dist

Compiled dist/server.cjs folder exists

Node Modules

Application dependencies are installed

MySQL Connection

DB_HOST, DB_USER, DB_NAME credentials set

Gemini AI

GEMINI_API_KEY set for public links analysis

Environment Parameters

Node.js Version: Loading...
Operational Port: Loading...
Node Env Variable: Loading...

Vite Compilation Required

The application has been successfully uploaded, but must be optimized and compiled into high-performance static files before Phusion Passenger can run it.

Why this is necessary:

Modern full-stack React applications bundle frontend CSS and TSX scripts into standard HTML/JS distribution assets inside a /dist folder. This folder is currently missing, making the launcher inactive.

VIEW APPMETRICS

Passive Deployment Methods (Manual Approach)

Method A: Offline Compilation (Recommended)
  1. Open the directory containing your project on your local computer's terminal.
  2. Install node dependencies if you haven't: npm install
  3. Run the compilation packager locally: npm run build
  4. This creates a directory named /dist in your root directory.
  5. Compress this /dist directory to a zip and upload it via cPanel File Manager. Extract it directly into your application root directory!
  6. Restart your application in cPanel "Setup Node.js App".
Method B: Terminal Compilation
  1. Sign in to your cPanel hosting account.
  2. Open the Terminal application (typically under the "Advanced" drawer).
  3. Copy the virtual environment activation script shown on top of your Node.js setup page and paste it into the terminal.
  4. Navigate to your application root directory.
  5. Execute: npm run build
  6. Once compile outputs finish, restart the App in the cPanel graphical UI!