Skip to content

Repository files navigation

Pingo for macOS

License: MIT Framework Platform Xcode macOS Apple

Pingo is a lightning-fast API scratchpad built for the macOS menu bar. It gives you a focused place to fire off small HTTP requests without opening a full API client.

Product website · Implementation reference

Designed for quick checks while building, debugging, or exploring APIs, Pingo keeps the essential request flow close at hand: choose a method, paste a URL, add headers or a body when needed, send the request, and inspect the response directly from a compact scratchpad window.

The app keeps the workflow intentionally lightweight. It is not meant to replace large API workspaces or team collections; it is a fast companion for the small requests developers make throughout the day.

Features

  • Menu bar first: open Pingo from the macOS menu bar whenever you need it.
  • Common HTTP methods: send GET, POST, PUT, PATCH, and DELETE requests.
  • Quick URL input: paste an endpoint and run it immediately.
  • Header editor: add request headers in a simple Name: Value format.
  • Body editor: write plain request payloads for methods that need a body.
  • Stateless requests: Pingo does not automatically store or resend cookies, cached responses, or HTTP credentials. Explicit Cookie, Authorization, and cache-control headers remain fully supported through the header editor.
  • Request control: cancel in-flight requests, with network timeouts to keep unresponsive endpoints from hanging the scratchpad.
  • Response viewer: inspect status, duration, content type, headers, and text response previews, with large bodies truncated for responsiveness.
  • Status feedback: see request progress, URL validation errors, and HTTP status codes, cancellations, and timeouts at a glance.

Development

macOS app

Open the project in Xcode and run the Pingo scheme:

open Pingo.xcodeproj

The native SwiftUI app is located in Pingo/.

Feature specifications for the native app live in docs/features/. Use the _template.md file when documenting a new feature. These specifications track macOS app changes only, not website changes.

Website

The Pingo website is developed separately in website/. Its Next.js application code is located in website/app/, with the landing page in website/app/page.tsx.

To run the website locally:

cd website
npm install
npm run dev

The development server is available at http://localhost:3000. See the website README for the available scripts and development details.

Maintainer instructions for publishing the macOS app, updating the Sparkle feed, and deploying the production website live in the release process.

Contributing

Contributions are welcome. Please keep changes focused and see CONTRIBUTING.md before opening a pull request.

Report security issues privately as described in SECURITY.md.

License

Pingo is released under the MIT License. See LICENSE.

About

An open-source API scratchpad for sending and inspecting HTTP requests from the macOS menu bar.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages