aytekinkaplan/book-tracker

This project is a simple book tracking application built with Express.js and Handlebars, performing CRUD operations.

---

Book Tracker

Book Tracker is a simple CRUD (Create, Read, Update, Delete) web application that allows users to track books they are reading or planning to read. Built using Node.js, Express, Handlebars, and MongoDB, it enables users to add, delete, and view a list of books.

Features

• Add a book with a title and author.
• View all added books.
• Delete a book from the list.
• Uses Handlebars for templating.
• MongoDB for storing book data.

Project Structure

book-tracker/
├── models/
│   └── Book.js        # Mongoose schema for the books
├── routes/
│   └── books.js       # Routes handling book operations
├── views/
│   ├── layouts/
│   │   └── main.hbs   # Main layout template
│   └── index.hbs      # Template for displaying the book list
├── app.js             # Main application entry point
├── package.json       # Project metadata and dependencies
├── screen.png         # Screenshot of the application
└── README.md          # Project documentation

Project Flowchart (Mermaid)

graph TD
    A[User] --> B[Express Server]
    B --> C{Routes}
    C --> D[GET /books - List books]
    C --> E[POST /books/add - Add book]
    C --> F[GET /books/delete/:id - Delete book]
    D --> G[MongoDB - Retrieve book data]
    E --> G[MongoDB - Save new book]
    F --> G[MongoDB - Remove book]
    G --> D
    G --> E
    G --> F
    B --> H[Handlebars Templates]
    H --> I[Render views with book data]

Loading

Installation

1. Clone the repository:

   git clone https://github.com/aytekinkaplan/book-tracker.git
   cd book-tracker

2. Install dependencies:

   npm install

3. Start MongoDB:

   Make sure MongoDB is running on your system. If you haven't installed it, follow the MongoDB installation guide.

4. Start the server:

   node app.js

5. Visit the application:

   Open your browser and go to http://localhost:5000/books to view the app.

Usage

1. Adding a Book:

   • On the main page, enter the book title and author's name in the form and click "Add Book."

2. Viewing Books:

   • All added books will be listed below the form.

3. Deleting a Book:

   • To remove a book, click the "Delete" button next to the book.

Screenshot

Here is a screenshot of the Book Tracker in action:

Technologies Used

• Node.js: Server-side JavaScript runtime.
• Express.js: Fast and lightweight web framework for Node.js.
• Handlebars: Templating engine for rendering dynamic HTML.
• MongoDB: NoSQL database for storing book data.
• Mongoose: MongoDB ODM to easily work with the database.

Contributing

1. Fork the project.
2. Create your feature branch: git checkout -b feature-name.
3. Commit your changes: git commit -m 'Add some feature'.
4. Push to the branch: git push origin feature-name.
5. Submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

---