juniper-graphql-worker

High-performance GraphQL APIs powered by Rust and Cloudflare Workers.

Overview

juniper-graphql-worker combines the speed and safety of Rust with the global edge network of Cloudflare Workers to deliver a lightning-fast GraphQL API. This project uses the Juniper GraphQL library for Rust, Axum for HTTP routing, and the Cloudflare Workers platform for serverless deployment.

Features

• Serverless
• Rust Performance
• GraphQL API
• Interactive Tools
• Type Safety
• Modular Design

Not implemented

• Websocket Subscriptions (Planned) - (A Cloudflare-specific Websocket implementation is required)

Getting Started

Bun manages the wrangler dependency and provides task execution. Source code for this project is written in Rust and targets wasm32-unknown-unknown.

Prerequisites

• Rust (1.86.0+)
• Bun (drop-in replacement for npm/yarn/pnpm)
• Wrangler (Cloudflare Workers CLI)

Installation

1. Clone the repository

   git clone https://github.com/geoffsee/juniper-graphql-worker.git
   cd juniper-graphql-worker

2. Install dependencies

   bun i

3. Start the development server

   bun dev

4. Navigate to http://localhost:3000/playground to interact with the GraphQL API

Optional: Deploy this api to the internet bunx wrangler deploy

Project Structure

• src/
  • lib.rs - Main application entry point and server setup
  • context.rs - GraphQL context setup
  • database.rs - Database connection and operations
  • models.rs - GraphQL object and input type definitions
  • schema.rs - GraphQL schema with queries and mutations

API Example

This GraphQL API implements a Star Wars-themed data model. Here's an example query:

query {
  human(id: "1") {
    id
    name
    homePlanet
    appearsIn
  }
}

And an example mutation:

mutation {
  createHuman(
    newHuman: {
      name: "Han Solo",
      homePlanet: "Corellia",
      appearsIn: [NEWHOPE, EMPIRE, JEDI]
    }
  ) {
    id
    name
    homePlanet
  }
}

Deployment

Deploy to Cloudflare Workers:

bunx wrangler deploy

Development

Extending the API

To extend the schema with new models:

1. Add model definitions in src/models.rs
2. Add new queries and mutations in src/schema.rs

Note: Your approach will vary based on your requirements.

Performance

Rust's efficiency combined with Cloudflare's edge network provides:

• Low latency responses
• Minimal cold starts
• Global distribution
• Small binary size

Tech Stack

• Rust - Systems programming language
• Juniper - GraphQL server library for Rust
• Axum - Web framework for Rust
• Cloudflare Workers - Serverless edge computing platform
• Wrangler - CLI tool for Cloudflare Workers

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License

Acknowledgments

• Juniper - GraphQL server library for Rust
• Axum - Web application framework for Rust
• Cloudflare Workers - Serverless platform

---

Created by Geoff Seemueller