npm package: @simonkov/use-axios
Description: A custom React hook that provides a state-driven interface for Axios requests.
Author: Simon Kovtyk
Latest version: 1.2.0

<div align="center">

  # useAxios
  A custom React hook that provides a state-driven interface for Axios requests.

  [![Last Release Badge](https://img.shields.io/github/v/release/simonkovtyk/use-axios?sort=semver&display_name=release&color=7300ff&labelColor=27272a)](../../releases/latest)
  [![GitHub License Badge](https://img.shields.io/github/license/simonkovtyk/use-axios?color=7300ff&labelColor=27272a)](./LICENSE)
  [![Contributions Welcomed Badge](https://img.shields.io/badge/contributions-welcomed-7300ff?labelColor=27272a)](#contributing)
  [![Sponsor Hint Badge](https://img.shields.io/badge/❤️-Sponsor_it-%23dc2626?style=flat&labelColor=27272a)](https://github.com/sponsors/simonkovtyk/)

</div>

## Introduction
It manages loading, success, and error states automatically, enabling seamless integration of asynchronous API calls into components.

The hook simplifies data fetching by exposing a clean API to trigger requests, track request state, and access response data or errors without manually handling state transitions.

## Install
<details open>
<summary>pnpm</summary>

```shell
pnpm i @simonkov/use-axios
```

</details>

<details>
<summary>npm</summary>

```shell
npm i @simonkov/use-axios
```

</details>

<details>
<summary>yarn</summary>

```shell
yarn add @simonkov/use-axios
```

</details>

Or just use your package manager of choice.

## Roadmap
1. Improve docs: I don't know if somebody every will use it. Currently, it's just ment for myself.
2. Add new features: Will probably never be removed from the roadmap.

## License
The MIT License (MIT) - Please have a look at the [LICENSE file](./LICENSE) for more details.

## Contributing
Contributions are always welcome and greatly appreciated. Whether you want to report a bug, suggest a new feature, or improve the documentation, your input helps make the project better for everyone.

Feel free to submit a pull request, issue or feature request.

### Issues and Feature Requests
Reporting an issue or creating a feature request is made by creating a new issue on this repository.

You can create a [new issue or feature request here](../../issues/new/choose).

### Pull Requests
GitHub offers a solid guideline for contributing to open source projects through pull requests, covering key practices. These best practices provide a reliable starting point for making effective contributions.

You can find the [guidelines here](https://docs.github.com/get-started/exploring-projects-on-github/contributing-to-a-project).

### Code Of Conduct
We are committed to keeping a welcoming, inclusive, and respectful community for everyone. To help us achieve this, we kindly ask that you adhere to our [Code of Conduct](./CODE_OF_CONDUCT.md).

## Legal

All trademarks and registered trademarks mentioned are property of their respective owners and are used for identification purposes only. Use of these names does not imply endorsement or affiliation.

This project is a trademark of Simon Kovtyk. The License does not grant rights to use the trademark without permission.

© 2025 — present by Maintainers & Simon Kovtyk