Skip to content

Sharkio is an API proxy for your development environments. It records all the requests that are sent to your API. It allows you to replay the requests easily. Generate types, documentation, test suites, And interact with your API using AI.

License

sharkio-dev/sharkio

Repository files navigation

logo

Sharkio

🐳 What is Sharkio

Sharkio is a development tool for api developers. It is a proxy that records all the requests that are sent to your servers. And provides you with a dashboard to analyze all the traffic. Sharkio also provides the ability to repeat requests. Generate types for youre favorite language based on real data.

Help us help you!

πŸ—ΊοΈ Roadmap

In the roadmap sharkio will support team functions. Also Sharkio will integrate with ChatGPT in order to allow easy use of api. Request automation. Api inconsistency alerting. Integration to Postman. Automatic CLI generation for your api with real data. Request mocking.

πŸ”– Features

Feature Name Available
Inspect traffic βœ…
Search βœ…
Filter βœ…
Repeat request βœ…
Typescript generator βœ…
JSON schema generator βœ…
Microservice support βœ…
Request mocks βœ…
Open api generator βœ…
Save requests βœ…
Collections βœ…
ChatGPT integration
Share requests

πŸ›  Tech Stack

πŸ› οΈ How to use

  1. Log in to https://sharkio.dev
  2. Setup your proxy (local server with ngrok or alternative)
  3. Change the configuration of the project to use https://<generated_subdomain>.sniffer.sharkio.dev
  4. Use Sharkio πŸŽ‰

πŸš€ Getting started

Running in development

  • npm i -g concurrently ts-node

For the backend

cd into server.

npm install

npm run dev

For the frontend

cd into client.

npm install

npm run dev

For both:

npm run dev ( in root directory )

Note:

Running in production - using Docker

Run whole project:

  • in root of project, use:
  • docker-compose up
  • NOTE: use ports 5550-5560 as proxies, make sure they are available.

Run backend/frontend only:

  • cd to relevent folder
  • build the Docker image: npm run docker:build
  • run the app: npm run docker:run

❓ Setup FAQs:

[1] Pre-commit hook is not installed during normal installation, what should I do? To setup husky [pre-commit hook] manually by running this command: `npm run prepare`
[2] What does `traffic-dashboard` and `traffic-snifer` directory contain? `traffic-dashboard` is the frontend code || `traffic-snifer` is the backend code

⚑ Social links

πŸ‘©πŸ»β€πŸ’» Want to contribute?

  • Fork the repo, clone it to your local environment and start exploring the code.
  • Look for an issue, preferably from the next milestone list.
  • Ask to be assigned to the issue.
  • Got stuck? need an advice? find us in the Discord server.
  • Found a bug? πŸ› please open an issue.

🀝 Acknowledgement

πŸ† Contributors

Appreciating all our fellow contributors:

About

Sharkio is an API proxy for your development environments. It records all the requests that are sent to your API. It allows you to replay the requests easily. Generate types, documentation, test suites, And interact with your API using AI.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published