Release notes

# Changelog

Keep track of all the latest updates, improvements, and bug fixes to our platform.

Updated October 3, 2025

Transformed the project into a production-ready monorepo with modern tooling, streamlined development workflows, and comprehensive code quality automation.

Monorepo Architecture and Developer Tooling Overhaul
New
  • Established pnpm workspaces monorepo structure separating marketing site and SaaS starter kit applications.
  • Implemented cross-workspace scripts for linting, formatting, and development workflows (dev:all, lint:all, format:all).
Improved
  • Migrated from deprecated next lint to modern ESLint CLI with comprehensive configuration and build directory exclusions.
  • Enhanced Prettier configuration with file-type specific formatting rules and better integration with ESLint.
  • Streamlined development experience with concurrent dev servers and unified workspace management.
Fixed
  • Resolved 26,000+ linting issues by properly excluding build artifacts and generated files from ESLint scanning.

Refined dashboard layout for better consistency, added location fields to profiles, and improved form interactions with searchable dropdowns and confirmation dialogs.

UI/UX Enhancements and Profile Features
Improved
  • Streamlined dashboard UI with consistent spacing, removed redundant data displays, and balanced section padding for a cleaner experience.
  • Enhanced social account selector with a searchable command palette dropdown for easier platform selection.
  • Wrapped auth layouts and protected routes with Suspense boundaries to fix useSearchParams prerender errors.
New
  • Added location fields (address, city, state, country, ZIP) to the profile form with a quick reset option.
  • Implemented confirmation dialogs for session revocation to prevent accidental actions.

Graduated the starter kit to v1.0.0 with production-ready session controls, hardened auth flows, and polished developer tooling.

General availability release
New
  • Shipped cross-device session management so users can review active logins and revoke any device instantly.
Improved
  • Refined account settings journeys and OAuth redirects to avoid accidental sign-out loops.
  • Unified auth mutation toasts and empty states for a consistent developer-facing experience.
Fixed
  • Patched token rotation edge cases uncovered during release hardening.

Focused on removing friction throughout authentication flows: cleaner redirect handling, clearer account feedback, and tighter OAuth guardrails.

New
  • Introduced a `useSafeRedirect` hook and wired it across auth forms to prevent unsafe navigation targets.
Improved
  • Streamlined password and email update screens with concise validation messaging.
  • Smoothed OAuth callback handling so GitHub and Google logins land on the intended destination every time.
Fixed
  • Eliminated stale session race conditions occurring during rapid provider switching.

Rebuilt the authenticated dashboard to spotlight developer-centric context with a new hero, account snapshot, and accessible quick actions.

Developer dashboard refresh
New
  • Introduced a hero layout with account badges, quick actions, and username status indicators.
  • Added preference summary blocks that surface theme, font, and username change availability.
Improved
  • Standardized protected dashboard spacing with shadcn tokens for a calmer reading rhythm.
Fixed
  • Gracefully handle missing profile documents with refresh and edit shortcuts.

Modernized the changelog experience with a tracing beam timeline, sticky release metadata, and tidy typography.

Changelog timeline upgrade
New
  • Embedded the tracing beam animation from the UI library to guide readers through releases.
Improved
  • Grouped change bullets by category with consistent spacing and iconography.
  • Added release count and last-updated badges to the header for quick context.
Fixed
  • Resolved mobile badge wrapping and ensured titles remain visible while scrolling.

Cut the first public-ready build of the SaaS starter with authentication, uploads, email flows, and polished marketing pages.

New
  • Email + OAuth auth flows with verification, password reset, and JWT rotation.
  • Avatar upload pipeline using UploadThing with client-side cropping.
Improved
  • Safe redirect helpers across auth routes to avoid stray dashboard loops.
  • SEO-ready marketing pages featuring hero, feature grid, tech stack, and FAQ blocks.
Fixed
  • Stabilized token refresh flow to recover gracefully from expired sessions.

Addressed early adopter feedback with OAuth callback hardening, upload resiliency, and UI tidy ups.

Fixed
  • Corrected OAuth callback redirects to honor safe return paths.
  • Resolved avatar deletion edge cases that left orphaned UploadThing files.
Improved
  • Clarified onboarding copy and FAQ answers on the marketing site.
  • Smoothed email templates with consistent typography and fallbacks.

Rolled out the public marketing surface with refreshed branding, iconography, and messaging tuned for the starter kit audience.

New
  • Published a marketing landing page with hero, feature grid, FAQ, and footer calls-to-action.
  • Added a collection of polished logo components for tech stack callouts.
Improved
  • Unified typography tokens across marketing sections for better readability.
Fixed
  • Tidied responsive spacing to prevent content clipping on small screens.

Polished the core auth experience with streamlined forms, clearer feedback, and reusable toast patterns.

New
  • Introduced reusable toast helpers to surface success and error states across auth flows.
Improved
  • Refined sign-in and sign-up layouts with better spacing, hint text, and validation messages.
  • Simplified forgot-password and verification handoffs to reduce drop-off.
Fixed
  • Resolved inconsistent focus rings between dark and light themes.

Laid the groundwork for persistent auth with MongoDB models, transactional email templates, and verification flows.

New
  • Defined Mongoose models for auth users, sessions, and profile documents with TypeScript safety.
  • Added email verification, welcome, and forgot-password templates powered by React Email.
Improved
  • Centralized JWT helpers for access/refresh token generation and validation.
Fixed
  • Patched early nodemailer configuration issues that blocked local delivery.

Established the Next.js App Router foundation with shadcn/ui primitives, theme switching, and protected route plumbing.

New
  • Bootstrapped Root and Auth providers with TanStack Query, theme handling, and session context.
Improved
  • Composed marketing hero, feature grid, and footer components as reusable blocks.
  • Implemented protected route HOC plus middleware-ready helpers for server APIs.
Fixed
  • Eliminated hydration warnings when toggling between light and dark themes.

Initial commit of the SaaS starter skeleton including linting, formatting, and foundational configuration.

Project initiation
New
  • Configured Next.js 14 App Router with TypeScript, ESLint, Prettier, and Turbopack dev tooling.
  • Added Tailwind CSS with shadcn/ui setup for rapid interface development.
Fixed
  • Resolved initial PNPM workspace quirks and ensured scripts run across Windows and macOS.