Quickstart Guide

Follow this guide to get up and running with the workshop environment in the fastest way possible.

Prerequisites

Before you begin, ensure you have the following installed:

• Git
• Node.js (version 18 or higher)

Additionally, you’ll need a Sentry account to follow along with the tracing and monitoring portions of this workshop:

• Sign up for a free Sentry.io if you don’t already have an account

Pro Tip

We recommend setting up two separate projects in your Sentry account: one for the frontend (React) and one for the backend (Node.js). This allows you to efficiently monitor each project more clearly. We’ll be configuring our SDKs in the workshop, so all you need to do is create the new projects and have your DSN’s handy.

Setup Instructions

1. Fork the repository

   Go to https://github.com/getsentry/sentry-academy-ai-workshop and click the “Fork” button in the top right. We’ll do this instead of simply cloning the repo because we’ll demo features of AI agent, Seer which can open PRs to fix code for us.

   

2. Leave the fork network

   Go to the settings of your forked repo, scroll all the way down to the Danger Zone, click “Leave fork network”, and follow the prompts to convert your forked repo into a standalone repo, all nice and isolated from the original.

   

3. Clone your no-longer-forked repo:

   git clone https://github.com/<your-username>/sentry-academy-ai-workshop.git

4. Navigate to the project directory

   cd sentry-academy-ai-workshop

5. Install dependencies with PNPM

   pnpm i

6. Set up environment variables

   touch apps/server/.env
   echo "PORT=3001" >> apps/server/.env
   cd apps/server

7. Database Setup

   We’ll be using NeonDB for this workshop, so we need to set up the database. Navigate to the apps/server directory and run the following commands and select the defaults when prompted:

   pnpx neondb

8. Seed the Database

   pnpm db:generate
   pnpm db:push
   pnpm db:seed

9. Start the Project (from the root)

   cd ../..
   pnpm dev

10. Access the application project

    The project will now be running at http://localhost:5173 with the backend API running on http://localhost:3001.

What’s Available After Setup

Once you’ve completed the setup, you’ll have access to:

• A Vite-powered React frontend running at http://localhost:5173
• A Node.js backend API running at http://localhost:3001
• Full-stack JavaScript application ready for Sentry instrumentation

This setup will allow you to progress through the workshop and start implementing Sentry. This workshop will take you through setting up Error Monitoring, Logging, Tracing, and building visualizations in dashboards!