Node.js Backend with TypeScript 🚀

A backend project built with Node.js and TypeScript to learn and apply modern backend development practices such as type safety, structured code, and scalable architecture.

This repository is part of my learning journey where I focus on writing real-world backend code, not just tutorials.

---

🧠 Purpose of This Project

• Learn how to use TypeScript with Node.js
• Understand backend folder structure and tooling
• Practice building APIs with type safety
• Prepare for frameworks like Express, NestJS, and React (TS)

---

🛠️ Tech Stack

• Node.js
• TypeScript
• ts-node
• nodemon
• (Express will be added later)

---

📁 Project Structure

.
├── src/
│   └── index.ts        # Entry point of the application
├── dist/               # Compiled JavaScript output
├── package.json
├── tsconfig.json
├── README.md

---

⚙️ Installation & Setup

1️⃣ Clone the repository

git clone https://github.com/your-username/node-ts-backend.git
cd node-ts-backend

2️⃣ Install dependencies

npm install

---

▶️ Running the Project

🔥 Development Mode (recommended)

Runs TypeScript directly with auto-reload.

npm run dev

🏗️ Build for Production

Compiles TypeScript to JavaScript.

npm run build

🚀 Start Production Server

npm start

---

📜 Available Scripts

Command	Description
npm run dev	Run server with ts-node & nodemon
npm run build	Compile TypeScript to JavaScript
npm start	Run compiled JS from dist/

---

🧩 TypeScript Configuration Highlights

• strict: true → Enables strong type safety
• rootDir: src → Keeps source code organized
• outDir: dist → Clean build output
• esModuleInterop: true → Smooth ES imports

---

🎯 Learning Goals

• TypeScript basics (types, unions, enums, classes)
• Node.js + TypeScript setup
• Express with TypeScript
• REST API design
• Environment variables
• Authentication (JWT)
• Database integration

---

🚧 Project Status

🟡 In Progress This project will evolve as I learn more backend concepts and tools.

---

🤝 Contributing

This is a personal learning project, but suggestions and improvements are welcome.

---

📄 License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

You are free to use, modify, and distribute this software, but any network-based use or modification must also make the source code available under the same license.

---

👨‍💻 Author

Arnab Bose 🌐 Website: https://arnabbose.dev 📧 Email: hello@arnabbose.dev

---

“Learning backend development by building, breaking, and fixing real systems.”