Skip to main content

​
Installation

Install the package via npm: 
npm install @basictech/expo

​
Define a schema

Define your database schema as a TypeScript constant (e.g., src/schema.ts): 
// src/basic.config.ts
export const schema = {
  project_id: 'YOUR_PROJECT_ID', // Replace with your actual project ID
  version: 1,
  tables: {
    // example table for a notes app
    notes: {
      type: 'collection',
      fields: {
        title: { type: 'string', indexed: true },
        content: { type: 'string' },
        createdAt: { type: 'number', indexed: true },
        completed: { type: 'boolean', indexed: true },
        priority: { type: 'number', indexed: true },
        tags: { type: 'json', indexed: true }
      },
    },
    // Add other tables here
  },
};

​
Provider Integration

Wrap your application’s root with the BasicProvider: 
// App.tsx
import { BasicProvider } from '@basictech/expo';
import { schema } from './basic.config';
import MainApp from './MainApp';

export default function App() {
  return (
    <BasicProvider schema={schema}>
      <MainApp />
    </BasicProvider>
  );
}
project_id is inferred from schema.project_id on BasicProvider; passing project_id separately is deprecated.
Note: Set the correct URI scheme under expo.scheme in app.json so OAuth redirects return to your app.

​
Authentication & State Management

Use the useBasic hook from @basictech/expo inside your components to access authentication state and database client: 
import { useBasic } from '@basictech/expo';

const { user, signIn, signOut, db, isLoading, isSignedIn } = useBasic();
Returned properties:
  • user: The authenticated user or null.
  • signIn(): Starts the OAuth login flow.
  • signOut(): Logs the user out, clearing all tokens.
  • db: The main database client.
  • isLoading: True during authentication state checks.
  • isSignedIn: Whether a user is authenticated.