Skip to main content

​
1. Generate a project key

Open Project Settings → API Key and generate a key if needed.

​
2. Pick your framework in settings

Go to Project Settings → App Logs and choose the closest setup tab:
  • Next.js
  • React
  • Node.js
  • Edge Function
  • Python
The page gives you the exact install command, env var name, init snippet, and example file location for that runtime.

​
3. Initialize the SDK

Follow the setup card in this order:
  1. install the package if the runtime needs one
  2. add the key to the correct env file or secret store
  3. initialize Aiola in the real app entrypoint
  4. optionally identify authenticated users with setUser

​
4. Add route wrappers where needed

The current snippets and in-app guidance specifically call out:
  • wrapping Next.js route handlers
  • wrapping Deno edge handlers
  • adding source map upload for build-based JavaScript apps

​
5. Use Add to App if you want Aiola to wire it for you

The Add to App button opens an Aiola thread with implementation instructions tailored to the selected framework, but it also tells the thread to inspect the actual codebase before editing anything.

​
6. Verify capture

After deployment or local setup, trigger a test error and confirm it appears in:
  • Project → App Logs
  • Central → App Logs
Check the grouped issue, stack trace, and metadata before calling the setup complete.