Skip to content

Run Locally

Each project runs in its own terminal. Start them in this order so the API is ready before the dashboard connects to it.

  1. Start the backend — open a terminal in news-server/:

    Terminal window
    cd news-server
    node server.js

    You should see output like:

    MongoDB connected
    Server running on port 4000
  2. Start the admin dashboard — open a new terminal in news-client/:

    Terminal window
    cd news-client
    npm run dev

    Vite starts on http://localhost:8080. Open it in your browser and log in.

  3. (Optional) Start a child-site frontend — each app in child-sites/ is independent:

    Terminal window
    cd child-sites/<app-name>
    npm install
    npm run dev

    Check the app’s package.json for its configured dev port.

After starting, verify each service is up:

ServiceURLExpected
news-serverhttp://localhost:4000Server responds (any route)
news-clienthttp://localhost:8080Login page loads
Terminal window
# Lint the dashboard
cd news-client && npm run lint
# Build the dashboard
cd news-client && npm run build
# Start the backend
cd news-server && node server.js
# Start this docs site
cd docs-site && npm run dev