Skip to content

osalama7/os-tweets-gql-api

Repository files navigation

os-tweets-gql-api

GQL API providing data for Tweet analytics

License: MIT

Description

This is a GraphQL API that provides data for Tweet analytics. It's built using TypeScript and powered by various technologies including Apollo Server, Prisma, and MongoDB.

Table of Contents

Installation

To get started with this project, follow these steps:

  1. Clone the repository:
git clone <repository-url>
cd os-tweets-gql-api
  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. Set up your environment variables by creating a .env file and configuring it.

  2. Start the application:

npm start

Usage

After installation, the GraphQL API will be accessible at http://localhost:<port>/graphql where <port> is the port you configured in your environment variables.

You can use tools like Apollo Studio or GraphQL Playground to interact with the API.

Development

If you want to contribute to this project or run it in a development environment, you can use the following scripts:

  • Start the development server with auto-reloading:
npm run dev
  • Generate Prisma client code:
npm run generate:prisma
  • Generate TypeScript types and resolvers using GraphQL Codegen:
npm run codegen

Testing

To run tests, use the following command:

npm test

We use Jest for testing, and you can add your test cases to the __tests__ directory.

Contributing

If you'd like to contribute to this project, please follow these guidelines:

  1. Fork the repository on GitHub.
  2. Create a new branch with a descriptive name.
  3. Make your changes and commit them.
  4. Push your changes to your fork and submit a pull request.

Please ensure your code follows the project's coding standards and is well-documented.

License

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


Feel free to modify the content and structure of this README to better suit your project's needs. Replace <repository-url> with the actual URL of your Git repository.

Releases

No releases published

Packages

No packages published

Languages