📚 GraphQL CRUD System

A simple CRUD API built with Express.js, TypeScript, GraphQL, and MongoDB, with a lightweight UI powered by Ruru HTML.

---

Live preview link

https://express-typescript-graphql.onrender.com/

🚀 Tech Stack

• Backend: Express.js + TypeScript
• API: GraphQL
• Database: MongoDB (Mongoose)
• UI/Playground: Ruru (GraphQL HTML IDE)

---

⚡ Features

• Manage Books and Authors with full CRUD operations.
• Query books and authors by ID or Name.
• Supports adding, updating, and deleting data.
• Simple UI with Ruru HTML for testing queries and mutations.

---

▶️ Getting Started

1. Clone the repo

Installation

Install this app with npm

1. Clone the repository:

   git clone https://github.com/Seyam08/express-typeScript-graphql.git
   

2. Make sure MongoDB is running locally or provide a connection string in .env:

   MONGO_CONNECTION_STRING="mongodb://localhost:27017/graphql"
   

3. Install the dependencies:

   npm install
   

4. Start the application:

   Development version

   npm run dev
   

5. Build

   npm run build
   

6. Run the Production server

   npm start
   

7. Open the package.json file to see all the scripts.

📖 Example Queries

Fetch all books and authors

query {
  allBooks {
    id
    name
    author {
      id
      name
    }
  }
  allAuthors {
    id
    name
  }
}

Fetch author and book by ID

query {
  authorById(id: "68e20964a7ad53a") {
    id
    name
  }
  bookById(id: "68e2096d3da7ad53a") {
    id
    name
    author {
      id
      name
    }
  }
}

Fetch book and author by name

query {
  authorByName(name: "Elif Shafak") {
    id
    name
  }
  booksByName(name: "The Forty Rules of Love") {
    id
    name
    author {
      id
      name
    }
  }
}

✍️ Example Mutations

Add a new author

mutation {
  addAuthor(name: "Elif Shafak") {
    id
    name
  }
}

Add a new book

mutation {
  addBook(authorName: "Elif Shafak", name: "The Forty Rules of Love") {
    id
    name
    author {
      id
      name
    }
  }
}

Update an author

mutation {
  updateAuthor(id: "68e2096d3d64c6f53a", newName: "Elif Shafak") {
    id
    name
  }
}

Update a book

mutation MyMutation {
  updateBook(id: "68e2096d3d64c6f53a", newName: "The Forty Rules of Love") {
    id
    name
    author {
      id
      name
    }
  }
}

Delete a book

mutation {
  deleteBook(id: "68e2096d3d642c6f53a") {
    id
    name
  }
}

📌 Notes

• All queries and mutations can be tested using Ruru HTML UI or tools like Postman / Insomnia.
• Make sure MongoDB is running before executing queries.