https://github.com/codestorm-official/nodejs-starter

A minimal Node.js web app built with Express.js — it just works.
https://github.com/codestorm-official/nodejs-starter

expressjs nodejs nodejs-starter nodejs-starter-kit nodejs-starter-template

Last synced: 9 days ago
JSON representation

A minimal Node.js web app built with Express.js — it just works.

• Host: GitHub
• URL: https://github.com/codestorm-official/nodejs-starter
• Owner: codestorm-official
• License: mit
• Created: 2026-05-06T01:46:36.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-05-06T02:41:32.000Z (about 2 months ago)
• Last Synced: 2026-05-06T04:09:43.055Z (about 2 months ago)
• Topics: expressjs, nodejs, nodejs-starter, nodejs-starter-kit, nodejs-starter-template
• Language: HTML
• Homepage: https://railway.com/deploy/nodejs-starter
• Size: 78.1 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![Railway](https://img.shields.io/badge/Railway-Supported-blue?logo=railway)

![Docker](https://img.shields.io/badge/Docker-Supported-blue?logo=docker)

![Node.js](https://img.shields.io/badge/Node.js-Supported-green?logo=node.js)

![Express](https://img.shields.io/badge/Express-Supported-green?logo=express)

# Node.js Express Starter

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/nodejs-starter?referralCode=asepsp&utm_medium=integration&utm_source=template&utm_campaign=generic)

A minimal, Docker-ready Node.js web application built with Express.js.

![](./img/homepage.png)

## Tech Stack

- **Runtime** — Node.js 20 (Alpine)

- **Framework** — Express.js

- **Config** — dotenv

- **Dev** — nodemon

- **Deploy** — Docker / Dokploy

## Project Structure

```

project/

├── public/         # Static files (HTML, CSS, JS)

├── routes/

│   └── index.js    # Route definitions

├── .env.example

├── .dockerignore

├── .gitignore

├── Dockerfile

├── LICENSE

├── package.json

└── server.js       # App entry point

```

## Getting Started

### Local Development

```bash

npm install

cp .env.example .env

npm run dev

```

### With Docker

```bash

docker build -t nodejs-starter .

docker run -p 3000:3000 --env-file .env nodejs-starter

```

Open [http://localhost:3000](http://localhost:3000)

## Endpoints

| Method | Path         | Description         |

| ------ | ------------ | ------------------- |

| GET    | `/`          | Landing page        |

| GET    | `/health`    | Server health check |

| GET    | `/api/hello` | Hello world         |

## Environment Variables

| Variable   | Default       | Description      |

| ---------- | ------------- | ---------------- |

| `PORT`     | `3000`        | Server port      |

| `NODE_ENV` | `development` | Environment mode |

## Deployment (Dokploy)

1. Push project to GitHub / GitLab

2. Create a new **Application** in Dokploy

3. Connect your repository

4. Dokploy auto-detects the `Dockerfile` and builds the image

5. Set environment variables in the **Environment** tab

6. Deploy

## License

MIT © 2025 Asep Saputra