Make repository
management simple

A modern HTTP client for browser + Node.js with a clean API and great defaults.

• Automatic JSON request/response handling
• Timeouts, cancelation, and interceptors
• Works the same in browser and Node.js

• Install
• Quick start
• Requests
• Configuration
• Error handling
• Interceptors
• Typed responses
• FAQ

npm install axios

import axios from 'axios';

const api = axios.create({
  baseURL: 'https://api.example.com',
  timeout: 10_000,
});

const { data } = await api.get('/users');
console.log(data);

Make requests with concise helpers like get, post, put, and delete.

Prefer a shared client instance to keep headers and timeouts consistent across your app.

Use defaults to avoid repeating base URLs, auth headers, and response parsing.

• Set a base URL for each environment
• Add headers once and reuse them everywhere
• Define timeouts for better UX

Standardize how you surface network errors and API responses.

Keep retry logic close to your client and away from your UI components.

Attach headers, refresh tokens, and add consistent error handling in one place.

api.interceptors.request.use((config) => {
  config.headers.set('x-client', 'repoflow-demo');
  return config;
});

api.interceptors.response.use(
  (res) => res,
  (err) => Promise.reject(err)
);

Use generics to keep your API calls safe and self-documenting.

type User = { id: string; name: string };

const { data } = await api.get<User[]>('/users');

Axios stays minimal by default. You can add a retry layer with a small helper (or a retry middleware) when you need it.

Yes. For very large files, prefer streaming APIs in Node.js and show progress in the UI where it matters.

Log request IDs and response status codes, and capture timings so you can compare slow calls across environments.