MIMS SDK Documentation
A comprehensive React SDK for document management, PDF viewing, form filling, and digital signatures. Build powerful document workflows in minutes.
Want to get started immediately? Check out our Quick Start Guide to have a working integration in under 5 minutes.
What is MIMS SDK?
MIMS SDK is a complete document infrastructure solution that provides React components and hooks for building document-centric applications. It handles the complexity of PDF rendering, form fields, digital signatures, and secure document submission, letting you focus on your application logic.
Key Features
How It Works
The MIMS SDK follows a simple integration pattern that works with any React application. Here's a high-level overview of the integration flow:
Add the SDK package to your project using your preferred package manager.
npm install @mims/sdk-react
Wrap your application with the MIMSProvider and provide your API key.
import { MIMSProvider } from '@mims/sdk-react';
function App() {
return (
<MIMSProvider apiKey={process.env.NEXT_PUBLIC_MIMS_API_KEY}>
<YourApp />
</MIMSProvider>
);
}
Import and use the PDF viewer and other components in your application.
import { PDFViewer } from '@mims/sdk-react';
function DocumentPage({ documentId, documentUrl }) {
return (
<PDFViewer
documentId={documentId}
documentUrl={documentUrl}
onSubmit={(payload) => console.log('Submitted:', payload)}
/>
);
}
When users complete and submit documents, the SDK automatically sends the data to our API, processes the PDF with embedded fields and signatures, and returns the completed document.
Architecture Overview
The SDK consists of three main parts:
-
MIMSProvider - The context provider that handles authentication, API communication, and SDK initialization. It must wrap all other SDK components.
-
Components - Ready-to-use React components like PDFViewer and SignaturePad that handle rendering and user interactions.
-
Hooks & Store - React hooks and a Zustand-based store for managing document state, field values, and programmatic control.
// The SDK architecture
<MIMSProvider apiKey="..."> {/* Authentication & API layer */}
<PDFViewer {/* UI Component layer */}
documentId="..."
documentUrl="..."
/>
</MIMSProvider>
// Under the hood:
// - MIMSProvider validates API key on mount
// - PDFViewer loads PDF and creates document store
// - User interactions update the store
// - On submit, data is sent to MIMS API
// - Processed PDF with embedded fields is returned
Requirements
Before integrating the SDK, ensure your environment meets these requirements:
- React 18+ - The SDK uses modern React features
- Node.js 18+ - For build and development
- TypeScript 5+ - Recommended for best developer experience
- MIMS API Key - Obtain from your MIMS dashboard
The SDK is framework-agnostic within the React ecosystem. It works with Next.js, Remix, Vite, Create React App, and any other React-based framework.