Skip to content

Commit

Permalink
Merge pull request #12 from AndrewWalsh/firefox-add-on
Browse files Browse the repository at this point in the history
feat: prep Firefox release
  • Loading branch information
AndrewWalsh authored Feb 21, 2024
2 parents 02921eb + 1b38640 commit 37addbc
Show file tree
Hide file tree
Showing 4 changed files with 19 additions and 15 deletions.
21 changes: 11 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

[![MIT License][license-shield]][license-url]
[![Download in the Chrome Web Store][chrome-shield]][chrome-url]
[![Download in the Firefox Add-on Store][firefox-shield]][firefox-url]

<!-- PROJECT LOGO -->
<br />
Expand All @@ -12,7 +13,7 @@


<p align="center" style="max-width: 600px;">
Effortlessly discover API behaviour with a Chrome/Firefox extension that automatically generates OpenAPI specifications in real time for any app or website.
Effortlessly discover API behaviour with a browser extension that automatically generates OpenAPI specifications in real time for any app or website.
<br />
<br />
<a href="https://awalsh.io/posts/openapi-devtools/">Read More</a>
Expand All @@ -30,7 +31,7 @@
<img width="80%" src="resources/demo.gif">
</p>

OpenAPI DevTools is a Chrome/Firefox extension that generates OpenAPI specifications in real time from network requests. Once installed it adds a new tab to Chrome DevTools called `OpenAPI`. While the tool is open it automatically converts network requests into a specification.
OpenAPI DevTools is a browser extension that generates OpenAPI specifications in real time from network requests. Once installed it adds a new tab to DevTools called `OpenAPI`. While the tool is open it automatically converts network requests into a specification.

*Features*:
- Instantly generate an OpenAPI 3.1 specification for any website or application just by using it
Expand All @@ -47,14 +48,17 @@ OpenAPI DevTools is a Chrome/Firefox extension that generates OpenAPI specificat
<img width="80%" src="resources/demo-img.png">
</p>

[Download the extension in the Chrome Web Store](https://chrome.google.com/webstore/detail/openapi-devtools/jelghndoknklgabjgaeppjhommkkmdii).
[Download the extension in the Chrome Web Store][chrome-url].

[Download the extension in the Firefox Add-on Store][firefox-url].

Otherwise, to install manually:
- [Download and extract the dist.zip file in the latest release](https://github.com/AndrewWalsh/openapi-devtools/releases/latest/download/dist.zip)
- In Chrome, navigate to `chrome://extensions`
- In the top right enable the `Developer mode` toggle
- In the top left click `Load unpacked` and select the extracted `dist` directory
- Open a new tab and then select `OpenAPI` in the developer tools (open with `cmd+i` or `ctrl+i`)
- Firefox is more challenging. Please use the add-on store.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

Expand All @@ -78,12 +82,7 @@ An [OpenAPI](https://www.openapis.org/) specification is a description of what a

To develop the project:
- `npm install`
- `npm run build`
- Navigate to `chrome://extensions` for Chromium based browser or `about:addons` for Firefox
- In the top right enable the `Developer mode` toggle
- In the top left click `Load unpacked` and select the `dist` directory
- You should now see the tool in DevTools. You can interact it with like a regular page, including inspection of the React app
- [Extensions Reloader](https://chrome.google.com/webstore/detail/extensions-reloader/fimgfedafeadlieiabdeeaodndnlbhid) is suggested to update the tool after running `npm run build` and updating the `dist` directory
- `npm run dev`

<p align="right">(<a href="#readme-top">back to top</a>)</p>

Expand All @@ -92,4 +91,6 @@ To develop the project:
[license-url]: https://github.com/AndrewWalsh/openapi-devtools/blob/main/LICENSE.txt
[license-shield]: https://img.shields.io/github/license/AndrewWalsh/openapi-devtools.svg?style=for-the-badge
[chrome-url]: https://chrome.google.com/webstore/detail/openapi-devtools/jelghndoknklgabjgaeppjhommkkmdii
[chrome-shield]: https://img.shields.io/badge/Google%20Chrome-4285F4?style=for-the-badge&logo=GoogleChrome&logoColor=white
[chrome-shield]: https://img.shields.io/badge/Google%20Chrome-4285F4?style=for-the-badge&logo=GoogleChrome&logoColor=white
[firefox-url]: https://addons.mozilla.org/en-US/firefox/addon/openapi-devtools/
[firefox-shield]: https://img.shields.io/badge/Firefox-FF7139?style=for-the-badge&logo=Firefox-Browser&logoColor=white
7 changes: 6 additions & 1 deletion manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,5 +9,10 @@
"32": "icon32.png",
"48": "icon48.png",
"128": "icon128.png"
},
"browser_specific_settings": {
"gecko": {
"id": "[email protected]"
}
}
}
}
6 changes: 2 additions & 4 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,8 @@
"type": "module",
"scripts": {
"test": "vitest",
"dev": "vite",
"run": "tsc && vite build && web-ext run -s dist",
"build": "tsc && vite build && web-ext build -s dist",
"zip": "web-ext build -s dist --overwrite-dest",
"dev": "tsc && vite build && web-ext run -s dist",
"build": "tsc && vite build && web-ext build --overwrite-dest -s dist",
"lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0 --fix"
},
"dependencies": {
Expand Down
Binary file removed resources/dist.zip
Binary file not shown.

0 comments on commit 37addbc

Please sign in to comment.