Skip to main content
Version: 1.1.4

Installation

Clone the repository​

git clone https://github.com/alse-sym/symphony-api-demo.git
cd symphony-api-demo

Install dependencies​

npm install

This installs Express, CORS middleware, and the UUID library. There are no native modules or build steps.

Start the server​

npm start

The server starts on port 3000 by default. You should see:

Symphony API listening on http://localhost:3000

Custom port​

Set the PORT environment variable to use a different port:

PORT=8080 npm start

Development mode​

Node.js 22+ includes a built-in watch mode. During development, use:

npm run dev

The server restarts automatically when you save a file in src/.

Verify the installation​

curl http://localhost:3000/api/health

Expected response:

{
  "status": "ok",
  "timestamp": "2026-02-18T12:00:00.000Z"
}

Project layout​

symphony-api-demo/
  src/
    index.js              Express entry point
    routes/
      projects.js         /api/projects endpoints
      tasks.js            /api/tasks endpoints
      teams.js            /api/teams endpoints
    data/
      projects.json       Seed data — 5 projects
      tasks.json          Seed data — 10 tasks
      teams.json          Seed data — 3 teams
    middleware/
      error-handler.js    Centralized error responses
  package.json
  README.md