nimbusdotstorage/Nimbus

• Navigate to Google Cloud console.

• Create a new project and navigate to its dashboard.

• Navigate to OAuth Consent Screen and enter the details.

  • Name: Nimbus
  • Audience: External
  • Contact info: [email protected]

• Navigate to Clients.

  • Type: Web application
  • Name: Nimbus
  • Add Authorised Javascript origin as http://localhost:3000
  • Add Authorised redirect uri as http://localhost:1284/api/auth/callback/google
  • IMPORTANT:Get your client_id and client_secret.

• Enable Google Drive API

  • Search for Google Drive API or Click Here.
  • Click Enable.

• Now navigate to Audience and add Test users.

Official Guide: Microsoft Register App

• Go to the Microsoft Azure Portal.

• Navigate to Microsoft Entra ID → Click Add → Click App registrations.

  • Name: Nimbus
  • Under Supported account types, choose: Accounts in any organizational directory and personal Microsoft accounts (i.e. all Microsoft account users).
  • Under Redirect URI, select Web and enter: http://localhost:1284/api/auth/callback/microsoft (Also add http://localhost:3000 under front-end origins if needed.)

• After registration, navigate to the app's Overview to copy your Application (client) ID.

• In the left menu, Click Manage. Use this to navigate.

• Navigate to Certificates & secrets → Click New client secret → Add a description and expiry → Click Add → Copy the generated secret value.

• Navigate to API permissions and make sure these delegated Microsoft Graph permissions are added and granted:

  • email – View users' email address
  • offline_access – Maintain access to data you have given it access to
  • openid – Sign users in
  • profile – View users' basic profile
  • User.Read – Sign in and read user profile
  • Files.ReadWrite.All – Have full access to user files (OneDrive access)

• Click Grant admin consent to apply the permissions.

Official Guide: Box Create OAuth 2.0 App

• Navigate to Box Developer Console console.

• Click Create App. Select Custom App.

• Fill in the form.

  • Name: Nimbus
  • Purpose: Integration
  • Categories: Productivity, Collaboration, Core Enterprise
  • External system are you integrating with: Box files
  • Click Next
  • Select User Authentication (OAuth 2.0)
  • Click Create App

• Copy the Client ID and Client Secret under OAuth 2.0 Credentials.

• Add OAuth 2.0 Redirect URIs as http://localhost:1284/api/auth/oauth2/callback/box.

Note: The redirect URI is different because it uses the generic oauth2 plugin from better-auth.

• Add Application Scopes:

  • Read all files and folders stored in Box
  • Write all files and folders stored in Box
  • Manage Users
  • Enable Integrations

• Add CORS Domains as http://localhost:3000.

• Click Save Changes.

Official Guide: Dropbox OAuth Guide

• Navigate to Dropbox App Console.

• Click Create App.

  • Select: Scoped Access
  • Select: Full Dropbox Access
  • Name: Nimbus

• Copy the App key and App secret.

• Add OAuth 2 Redirect URIs as http://localhost:1284/api/auth/callback/dropbox.

• Navigate to Permission and add Scopes.

  • account_info.read
  • files.metadata.read
  • files.content.read
  • files.content.write
  • sharing.read

• Click Submit in the pop up bar.

1. Go to Resend.com and sign up or log in to your account.

2. From the dashboard, click on "API Keys" in the sidebar.

3. Click the "Create API Key" button.

4. Enter a name for your key (e.g., nimbus-dev) and confirm.

5. Copy the generated API key.

6. Add it to your .env file: