🤝 Connect With Me

Profscode CRUD

A lightweight, GetX-friendly HTTP CRUD helper for Flutter & Dart.

Designed to be fully user-controlled: no global singletons, no forced tokens, no hidden state.

Supports all common HTTP methods with optional token refresh logic, making it ideal for clean, scalable API layers.

✨ Features

GET, POST, PUT, DELETE
PATCH, HEAD, OPTIONS
File & multipart upload support
Optional custom headers
Optional automatic token refresh
No global state, fully injectable
Simple, readable API surface
Built on top of http + GetX

📦 Installation

Add to your pubspec.yaml:

dependencies:
  profscode_crud:
    git:
      url: https://github.com/Ahmedhafiz33/profscode_crud.git
      ref: main

Then run:

flutter pub get

🚀 Usage

1️⃣ Basic Setup

import 'package:profscode_crud/profscode_crud.dart';

final crud = Crud(
  headersProvider: () => {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  onRefreshToken: () async {
    // Optional refresh token logic
    // Return true if refresh succeeds
    return false;
  },
);

final response = await crud.getRequest(
  'https://api.example.com/users',
);

print(response);

2️⃣ POST Request

final data = {
  'name': 'John',
  'email': 'john@example.com',
};

final response = await crud.postRequest(
  'https://api.example.com/users',
  data,
);

print(response);

3️⃣ PUT Request

final updateData = {'name': 'Jane'};

final response = await crud.putRequest(
  'https://api.example.com/users/1',
  updateData,
);

print(response);

4️⃣ PATCH Request

final response = await crud.patchRequest(
  'https://api.example.com/users/1',
  {'email': 'new@mail.com'},
);

print(response);

5️⃣ DELETE Request

final response = await crud.deleteRequest(
  'https://api.example.com/users/1',
);

print(response);

6️⃣ HEAD & OPTIONS

final head = await crud.headRequest(
  'https://api.example.com/users',
);

final options = await crud.optionsRequest(
  'https://api.example.com/users',
);

7️⃣ File Upload

final response = await crud.fileRequest(
  'https://api.example.com/upload',
  fields: {
    'user_id': '1',
  },
  files: [
    // http.MultipartFile instances
  ],
);

print(response);

🔐 Automatic Token Refresh

final crud = Crud(
  headersProvider: () => {
    'Authorization': 'Bearer $accessToken',
  },
  onRefreshToken: () async {
    final newToken = await fetchNewToken();
    if (newToken != null) {
      accessToken = newToken;
      return true;
    }
    return false;
  },
);

When the API returns 401 Unauthorized, onRefreshToken is called automatically and the request is retried once.

✅ Why Profscode CRUD?

No hidden magic
No forced architecture
No global dependencies
Works perfectly with GetX
Easy to test, easy to extend
Suitable for real production apps

🤝 Contributing

Contributions are welcome.

Ideas:

Logging helpers
Retry strategies
Response wrappers
Examples & tests

Feel free to open an issue or submit a pull request.