docs: remove hardcoded Sentry config and clean up README

- Move Sentry organization and project names to environment variables
- Update build.mjs to use SENTRY_ORG and SENTRY_PROJECT env vars
- Update GitHub workflows to use secrets instead of hardcoded values
- Add SENTRY_ORG and SENTRY_PROJECT to .env.example documentation
- Remove organization-specific Sentry URLs from README and .env.example
- Remove redundant "Why This Setup?" section from README

Author: rui-batalabs

.env.example

@@ -126,7 +126,6 @@ FREE_TIER_NOTE_LIMIT=100# Note count limit for free users (default: 100)
 # ================================================================
 
 # Sentry.io Error Tracking (OPTIONAL)
-# Get your DSN from: https://sentry.io/settings/bata-labs/projects/typelets-api/keys/
 # Format: https://<key>@<org-id>.ingest.us.sentry.io/<project-id>
 # SENTRY_DSN=https://your-sentry-dsn-here
 # Error tracking, performance monitoring, and profiling are enabled by default
@@ -138,6 +137,11 @@ FREE_TIER_NOTE_LIMIT=100# Note count limit for free users (default: 100)
 # SENTRY_AUTH_TOKEN=your-sentry-auth-token-here
 # This is only needed during production builds to upload source maps
 
+# Sentry Organization and Project (REQUIRED for production builds with source maps)
+# These are used during the build process to upload source maps
+# SENTRY_ORG=your-sentry-organization-slug
+# SENTRY_PROJECT=your-sentry-project-slug
+
 # Application Logging
 # Structured logs are automatically generated for:
 # - Authentication events

.github/workflows/release.yml

@@ -35,6 +35,8 @@ jobs:
         env:
           NODE_ENV: production
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
+          SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
+          SENTRY_PROJECT: ${{ secrets.SENTRY_PROJECT }}
         run: NODE_OPTIONS="--max-old-space-size=8192" pnpm run build
 
       - name: Release

.github/workflows/sentry-release.yml

@@ -23,8 +23,8 @@ jobs:
       - name: Create Sentry Release
         env:
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
-          SENTRY_ORG: bata-labs
-          SENTRY_PROJECT: typelets-api
+          SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
+          SENTRY_PROJECT: ${{ secrets.SENTRY_PROJECT }}
         run: |
           # Create new release
           sentry-cli releases new "${{ env.RELEASE_VERSION }}"

README.md

@@ -10,6 +10,43 @@
 
 The backend API for the [Typelets Application](https://github.com/typelets/typelets-app) - a secure, encrypted notes management system built with TypeScript, Hono, and PostgreSQL. Features end-to-end encryption support, file attachments, and folder organization.
 
+## Table of Contents
+
+- [Features](#features)
+- [Tech Stack](#tech-stack)
+- [Prerequisites](#prerequisites)
+- [Local Development Setup](#local-development-setup)
+  - [Quick Start](#quick-start)
+  - [Development Workflow](#development-workflow)
+- [Alternative Installation Methods](#alternative-installation-methods)
+- [Available Scripts](#available-scripts)
+- [API Endpoints](#api-endpoints)
+  - [Public Endpoints](#public-endpoints)
+  - [Authentication](#authentication)
+  - [Interactive Documentation](#interactive-documentation)
+  - [WebSocket Real-time Sync](#websocket-real-time-sync)
+- [Database Schema](#database-schema)
+- [Security Features](#security-features)
+- [Environment Variables](#environment-variables)
+- [Monitoring with Sentry.io](#monitoring-with-sentryio)
+  - [Features](#features-1)
+  - [Configuration](#configuration)
+  - [Source Maps](#source-maps)
+  - [Automated Release Tracking](#automated-release-tracking)
+- [Development](#development)
+  - [Project Structure](#project-structure)
+  - [Type Safety](#type-safety)
+- [Docker Support](#docker-support)
+- [Production Deployment](#production-deployment)
+- [Contributing](#contributing)
+  - [Getting Started](#getting-started)
+  - [Commit Message Format](#commit-message-format)
+  - [Pull Request Process](#pull-request-process)
+  - [Reporting Issues](#reporting-issues)
+  - [Security Vulnerabilities](#security-vulnerabilities)
+- [License](#license)
+- [Acknowledgments](#acknowledgments)
+
 ## Features
 
 - 🔐 **Secure Authentication** via Clerk
@@ -111,12 +148,6 @@ pnpm run dev
 
 The development server will automatically restart when you make changes to any TypeScript files.
 
-### Why This Setup?
-
-✅ **PostgreSQL in Docker**: Easy to start/stop, no local PostgreSQL installation needed  
-✅ **API with pnpm**: Hot reload, easy debugging, faster development cycle  
-✅ **Clean separation**: Matches production architecture (API + external database)
-
 ### Development Workflow
 
 ```bash
@@ -309,8 +340,6 @@ Sentry is configured in the application with:
 SENTRY_DSN=https://your-key@your-org-id.ingest.us.sentry.io/your-project-id
 ```
 
-Get your DSN from: [Sentry.io Project Settings](https://sentry.io/settings/bata-labs/projects/typelets-api/keys/)
-
 Once configured, all errors are automatically captured and sent to Sentry with contextual information including:
 
 - Error ID for tracking

build.mjs

@@ -20,8 +20,8 @@ const buildOptions = {
 if (isProduction && process.env.SENTRY_AUTH_TOKEN) {
   buildOptions.plugins = [
     sentryEsbuildPlugin({
-      org: "bata-labs",
-      project: "typelets-api",
+      org: process.env.SENTRY_ORG,
+      project: process.env.SENTRY_PROJECT,
       authToken: process.env.SENTRY_AUTH_TOKEN,
 
       // Upload source maps to Sentry