Flashcards

Flashcards is a demo CRUD application for creating flashcards and categories, built with Next.js and Django and instrumented with Sentry for a workshop on error monitoring.

What is Flashcards?

Flashcards is a simple CRUD app that lets users create their own flashcards and categories, then practice by being shown the cards. It runs as a dockerized full-stack project with a Next.js frontend and a Django backend, and is the working material for a Sentry.io workshop. The repository is maintained by Sentry and has 53 stars on GitHub.

What makes Flashcards stand out?

Flashcards stands out because it is explicitly designed to be broken: the workshop instructs users to test all features and then look at Sentry to find the errors that were automatically captured. The stack is concrete and modern: Next.js on the frontend, Django with the Sentry SDK on the backend, and PostgreSQL for storage, all orchestrated with Docker Compose.

• CRUD flashcard workflow — create, view, update, and delete flashcards through a web UI.
• Category organization — define custom categories and assign flashcards to them.
• Practice mode — the app shows cards one by one so users can test their knowledge.
• Sentry error tracking — both frontend and backend report to a Sentry project, making exceptions visible in one dashboard.
• One-command Docker setup — docker compose up --build brings up the whole stack, including the database.
• Workshop-oriented structure — the README walks through connecting a new Sentry account, creating a Next.js project, and running the @sentry/wizard CLI.

Who should use Flashcards?

Flashcards is aimed at developers participating in Sentry's workshop, but it is also useful as a minimal full-stack reference project. Workshop attendees use it to practice diagnosing errors in a real application. Developers unfamiliar with Sentry can use it to see how the Next.js wizard and Django SDK are configured side by side.

What can you do with Flashcards?

• Sentry workshop participants: follow the getting-started steps to wire a Next.js and Django project to Sentry, then intentionally trigger bugs and watch them surface in the dashboard.
• Full-stack learners: study a small but real codebase combining Next.js, Django, PostgreSQL, and Docker in one repository.
• Monitoring testers: verify that the Sentry SDK captures both frontend and backend exceptions by exercising every feature of the app and checking the issue feed.

How does Flashcards work?

The app is started with docker compose up --build. After creating a Sentry account and a Sentry Next.js project, you run npx @sentry/wizard@latest -i nextjs to set up frontend monitoring. For the backend, add sentry-sdk[django] to requirements.txt and configure the Sentry Django SDK, then rebuild the containers if needed.

FAQ

Is Flashcards free?

The repository is a public demo project from Sentry, and the README does not mention any cost. It is meant to be run locally with Docker for the workshop.

What technologies does Flashcards use?

The app uses Next.js for the frontend, Django for the backend, and PostgreSQL as the database, all running in Docker containers via Docker Compose.

How do I get errors to show up in Sentry?

You need a Sentry account, a Next.js project, and a Django project. Set up the frontend with the Sentry wizard and the backend with sentry-sdk[django], then restart the containers. Any errors you trigger in the app should appear in the Sentry issue feed.