## Building a Simple Application with Node.js Building a basic application in Node.js is a straightforward process. It typically involves the following steps: * Installing Node.js and npm * Setting up the project directory * Initializing the project configuration * Creating an HTTP server * Handling incoming requests and sending back responses In this tutorial, we will walk you through these steps to build and run your first Node.js HTTP application from scratch. --- ### 1. Install Node.js Before you begin, make sure Node.js and npm (Node Package Manager) are installed on your system. You can verify this by running the following commands in your terminal: ```bash node -v npm -v ``` If they are not installed, please download and install the LTS version from the official [Node.js website](https://nodejs.org/). --- ### 2. Create the Project Directory Open your terminal, create a new directory named `my-first-node-app`, and navigate into it: ```bash mkdir my-first-node-app cd my-first-node-app ``` --- ### 3. Initialize the Project Initialize your project by generating a `package.json` file, which manages your project's metadata and dependencies. Run the following command to initialize the project with default settings: ```bash npm init -y ``` Next, open the generated `package.json` file and modify its contents to match the configuration below. This sets `app.js` as the entry point and defines a convenient start script: ```json { "name": "my-first-node-app", "version": "1.0.0", "main": "app.js", "scripts": { "start": "node app.js" }, "dependencies": {} } ``` --- ### 4. Create the Application Entry File In the root of your `my-first-node-app` directory, create a new file named `app.js`. This will serve as the entry point where we configure our server and handle incoming requests. --- ### 5. Write the Server Code Open `app.js` in your favorite code editor and add the following code to create a basic HTTP server: ```javascript const http = require('http'); // Create the HTTP server const server = http.createServer((req, res) => { // Set the HTTP response status code and headers res.writeHead(200, { // Set the content type to HTML and specify UTF-8 encoding to support international characters 'Content-Type': 'text/html; charset=utf-8' }); // Send the response body and end the request res.end('

Hello, World!

This is my first Node.js application.

'); }); // Define the port to listen on const PORT = 3000; server.listen(PORT, () => { console.log(`Server is running on http://localhost:${PORT}`); }); ``` --- ### 6. Run the Server Start your application by running the start script in your terminal: ```bash npm start ``` You should see the following output in your console: ```text Server is running on http://localhost:3000 ``` --- ### 7. Test the Application Open your web browser and navigate to `http://localhost:3000`. You should see your HTML message displayed on the page: ```text Hello, World! This is my first Node.js application. ``` --- ### 8. Add Basic Routing To make your application more interactive, you can inspect the request URL (`req.url`) and implement basic routing. Update your `app.js` file with the following code: ```javascript const http = require('http'); const server = http.createServer((req, res) => { // Route: Homepage if (req.url === '/') { res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' }); res.end('Welcome to the homepage!'); } // Route: About Page else if (req.url === '/about') { res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' }); res.end('This is the about page.'); } // Route: 404 Not Found else { res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' }); res.end('404 Not Found'); } }); const PORT = 3000; server.listen(PORT, () => { console.log(`Server is running on http://localhost:${PORT}`); }); ``` Restart your server (press `Ctrl + C` to stop it, then run `npm start` again) and test the different paths: * `http://localhost:3000/` -> Displays "Welcome to the homepage!" * `http://localhost:3000/about` -> Displays "This is the about page." * `http://localhost:3000/anything-else` -> Displays "404 Not Found" --- ### Considerations & Next Steps * **Development Workflow:** Manually restarting the server after every code change can be tedious. Consider installing `nodemon` (`npm install --save-dev nodemon`) to automatically restart your server when files change. * **Production Readiness:** The built-in `http` module is excellent for understanding Node.js fundamentals. However, for larger production applications, developers typically use robust web frameworks like **Express**, **Fastify**, or **NestJS** to handle complex routing, middleware, and security. * **Scalability:** This basic setup can easily be extended by connecting to databases (such as MongoDB or PostgreSQL) and implementing RESTful APIs.