feat: initialize the template with basic settings

Author: coder7475

.dockerignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+.env
+Dockerfile
+docker-compose.yml

.env.example

@@ -0,0 +1,2 @@
+# Server Configuration
+PORT=3000

.gitignore

@@ -0,0 +1,30 @@
+# Node dependencies
+node_modules/
+
+# Production build
+dist/
+
+# Environment variables
+.env
+
+# Logs
+logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+yarn-debug.log*
+
+# IDE configs
+.vscode/
+.idea/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Docker artifacts
+docker-compose.override.yml
+
+# TypeScript cache
+*.tsbuildinfo
+

Dockerfile

@@ -0,0 +1,22 @@
+# Build stage
+FROM node:22 AS builder
+
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+WORKDIR /app
+COPY . .
+
+RUN pnpm install
+RUN pnpm run build
+
+# Production stage
+FROM node:22-slim
+
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY package.json pnpm-lock.yaml ./
+RUN pnpm install --prod
+
+CMD ["node", "dist/server.js"]

README.md

@@ -0,0 +1,105 @@
+# Express + TypeScript + Docker Template
+
+A starter template for building modern backend applications with **Express.js**, **TypeScript**, **Docker**, and **pnpm**. Perfect for local development and production-ready deployments.
+
+---
+
+## 🚀 Features
+
+- ⚡️ Express.js with TypeScript
+- 📦 pnpm as package manager
+- 🐳 Docker support for dev & prod
+- 📂 Modular folder structure
+- 🌱 `.env` environment configuration
+- 🔁 Hot-reloading with `ts-node-dev`
+
+---
+
+## 🧱 Project Structure
+
+```
+
+.
+├── src/
+│ ├── routes/
+│ │ └── index.ts # Sample route
+│ ├── app.ts # Express app config
+│ └── server.ts # Entry point
+├── .env # Environment variables
+├── Dockerfile # Production Docker build
+├── docker-compose.yml # Dev environment
+├── package.json # Project metadata
+├── tsconfig.json # TS config for dev
+├── tsconfig.build.json # TS config for prod build
+└── README.md # You're here!
+
+```
+
+---
+
+## 🛠️ Development Setup
+
+1. **Install dependencies**
+
+```bash
+pnpm install
+```
+
+2. **Run locally**
+
+```bash
+pnpm run dev
+```
+
+3. **Lint and type-check (optional)**
+
+```bash
+pnpm run build
+```
+
+---
+
+## 🐳 Docker Usage
+
+### Run in Development Mode
+
+```bash
+docker-compose up --build
+```
+
+### Build for Production
+
+```bash
+docker build -t express-ts-app .
+```
+
+### Run in Production
+
+```bash
+docker run -p 3000:3000 --env-file .env express-ts-app
+```
+
+---
+
+## 🌐 Access the App
+
+After running in any mode, open:
+
+```
+http://localhost:3000
+```
+
+---
+
+## 📦 Built With
+
+- [Express](https://expressjs.com/)
+- [TypeScript](https://www.typescriptlang.org/)
+- [pnpm](https://pnpm.io/)
+- [Docker](https://www.docker.com/)
+
+---
+
+## 📄 License
+
+MIT – feel free to use and modify.

docker-compose.yml

@@ -0,0 +1,15 @@
+version: "3.8"
+
+services:
+  app:
+    container_name: express-ts-dev
+    build:
+      context: .
+      dockerfile: Dockerfile
+    volumes:
+      - .:/app
+      - /app/node_modules
+    ports:
+      - "3000:3000"
+    command: pnpm run dev
+    env_file: .env

package.json

@@ -0,0 +1,21 @@
+{
+  "name": "express-ts-docker-template",
+  "version": "1.0.0",
+  "main": "dist/server.js",
+  "scripts": {
+    "dev": "ts-node-dev --respawn --transpile-only src/server.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "start": "node dist/server.js"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "dotenv": "^16.0.3"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.4.2",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.2.2"
+  },
+  "packageManager": "pnpm@10.12.1"
+}