Skip to content

CHANGELOG.md

Latest commit

 

History

History
258 lines (203 loc) · 10.9 KB

CHANGELOG.md

File metadata and controls

258 lines (203 loc) · 10.9 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

0.5.0 - 2026-01-18

Added

  • Cloudflare R2 storage client (src/lib/r2-client.ts) with presigned URLs for file uploads
  • R2 setup documentation (docs/R2_SETUP.md) with complete configuration guide
  • Date utilities (src/lib/dates.ts) for consistent date formatting across the app
  • Environment loader (src/lib/load-env.ts) for standalone scripts (drizzle-kit, tsx)
  • Claude Code commands aligned with plannerinator-next best practices:
    • /check - Format, lint, build with proper fix guidelines (no eslint-disable hacks)
    • /ship - Complete release workflow (check + changelog + release in one command)
    • /archive-changelog - Archive old changelog versions when file exceeds 1000 lines
  • Commands documentation (.claude/COMMANDS.md) with detailed usage examples

Changed

  • Updated to Next.js 16.1.3, React 19.2.3, Better Auth 1.4.15, and 20+ other dependencies
  • Improved ESLint configuration for Next.js 16 compatibility (migrated from FlatCompat to direct imports)
  • Enhanced /changelog command with dependency update grouping (max 2-3 lines instead of listing all)
  • Enhanced /release command with changelog archive check reminder
  • Updated .env.example with R2 configuration variables (commented, optional)
  • Improved PostForm to use useWatch instead of watch for React Compiler compatibility
  • Improved ThemeToggle to use startTransition for hydration safety
  • Refactored profile page to use centralized date helper functions
  • Updated drizzle.config.ts to use loadEnv() for consistent environment loading

Fixed

  • Better Auth v1.4 compatibility: custom forgetPassword client implementation and updated verify signature
  • ESLint configuration error with Next.js 16 (circular structure in FlatCompat)
  • React Compiler warnings for impure functions (Date.now()) and setState in effects
  • Type safety improvements in auth types with explicit AppUser and AppSession interfaces

0.4.1 - 2025-10-22

Fixed

  • Moved custom password hashing configuration inside emailAndPassword block in Better Auth configuration to ensure PBKDF2 functions are properly used instead of default scrypt algorithm

0.4.0 - 2025-10-13

Added

  • Comprehensive limitations documentation (docs/LIMITATIONS.md) covering platform constraints, intentional design decisions, and migration paths
  • Supabase integration guide (docs/SUPABASE_INTEGRATION.md) for adding real-time features, enhanced storage, and database capabilities
  • Supabase recipe directory (docs/recipes/supabase/) with step-by-step integration examples
  • Detailed platform constraints section in README explaining Cloudflare Workers limitations and when NOT to use the template
  • Expanded AI workflow guide with constraint awareness, decision trees, and best practices for AI assistants

Changed

  • Enhanced /changelog command with more comprehensive analysis instructions and quality checks
  • Improved /deploy command documentation with better formatting and troubleshooting steps
  • Enhanced /release command with more detailed versioning guidance and edge case handling
  • Updated README structure with prominent trade-offs section and known limitations overview
  • Improved environment setup documentation with better markdown formatting and clearer tables
  • Standardized code formatting across deployment scripts and configuration files
  • Enhanced AI workflow documentation with 175+ lines of constraint-aware development guidance

Fixed

  • Markdown escaping for asterisks in CHANGELOG.md to prevent formatting issues
  • Code formatting consistency in scripts/deploy.mjs using Prettier standards
  • Import organization in dashboard components for better readability

0.3.1 - 2025-10-12

Changed

  • Updated production URL from templator.gen-8ae.workers.dev to custom domain templator.essedev.it in deployment configuration

0.3.0 - 2025-10-12

Added

  • Environment setup documentation (ENV_SETUP.md) with comprehensive guide for local and production environment configuration
  • Terms of Service page (src/app/terms/page.tsx)
  • Privacy Policy page (src/app/privacy/page.tsx)
  • Automated deployment script (scripts/deploy.mjs) that handles NEXTPUBLIC* variables correctly during build

Changed

  • Simplified .env.example with clearer local development focus and reference to production config in wrangler.jsonc
  • Updated wrangler.jsonc with production environment variables (BETTERAUTH_URL, EMAIL*, etc.)
  • Improved .gitignore to better exclude build artifacts and environment files
  • Enhanced dashboard layout with comprehensive authentication documentation comments
  • Improved login page with hard redirect using window.location.href for reliable session establishment
  • Updated dashboard pages with better session handling
  • Refined dashboard navigation component
  • Updated /changelog and /release command documentation with better formatting

Removed

  • Next.js authentication middleware (src/middleware.ts) - authentication now handled by Better Auth and dashboard layout

0.2.0 - 2025-10-12

Changed

  • BREAKING: Migrated authentication from NextAuth v5 to Better Auth v1
    • Better edge compatibility with Cloudflare Workers
    • Improved TypeScript support and developer experience
    • Built-in email verification and password reset flows
    • Custom PBKDF2 password hashing (100k iterations)
    • Edge-compatible rate limiting with database storage
  • Updated all authentication-related pages and components to use Better Auth client
  • Refactored database schema to use Better Auth naming conventions (snake_case)
  • Enhanced RBAC system with Better Auth's custom fields
  • Simplified authentication middleware with Better Auth session handling
  • Updated all feature modules (auth, blog, contact, newsletter, profile, users) to work with Better Auth

Added

  • New authentication documentation:
    • docs/AUTHENTICATION.md - Complete Better Auth implementation guide
    • docs/AUTHENTICATION_ADVANCED.md - Advanced features and customization
    • docs/MIDDLEWARE.md - Middleware and protected routes guide
    • docs/DEPLOYMENT.md - Deployment configuration for Better Auth
  • Better Auth client (src/lib/auth-client.ts) for client-side authentication
  • Better Auth API route (src/app/api/auth/[...all]/route.ts)
  • Custom email templates for Better Auth (src/lib/emails/auth-emails.ts)
  • New RBAC helper (src/lib/rbac.ts) with Better Auth integration
  • Improved auth verification and password reset flows (searchParams-based)
  • Enhanced feature READMEs with Better Auth examples and best practices

Removed

  • NextAuth v5 and @auth/drizzle-adapter dependencies
  • Legacy NextAuth route (src/app/api/auth/[...nextauth]/route.ts)
  • Legacy NextAuth type definitions (src/types/next-auth.d.ts)
  • Legacy email actions file (src/features/auth/email-actions.ts)
  • Legacy token-based verification/reset routes (migrated to searchParams)
  • docs/EXAMPLES.md (content redistributed to feature READMEs)

Fixed

  • Edge runtime compatibility issues with authentication flows
  • Session handling in middleware for protected routes
  • Type safety improvements across authentication system

0.1.2 - 2025-10-10

Added

  • Claude Code slash commands:
    • /changelog command to automatically update CHANGELOG.md with recent changes
    • /release command for streamlined version releases

Changed

  • Improved /changelog command with better formatting instructions and [Unreleased] section handling

Fixed

  • Fixed Next.js metadataBase warning by ensuring metadataBase is always set in metadata configuration
  • Social Open Graph and Twitter Card images now properly resolve with absolute URLs

0.1.1 - 2025-10-10

Added

  • SEO essentials:
    • Dynamic robots.txt with search engine directives
    • Dynamic sitemap.xml with static and blog routes
    • Enhanced metadata utility with Open Graph and Twitter Cards support
    • Improved metadata across all pages (homepage, blog, pricing, contact)
  • Security headers:
    • X-DNS-Prefetch-Control for DNS prefetching
    • Strict-Transport-Security (HSTS) for HTTPS enforcement
    • X-Frame-Options to prevent clickjacking
    • X-Content-Type-Options to prevent MIME sniffing
    • Referrer-Policy for referrer information control
    • Permissions-Policy to disable unused browser features

Changed

  • Migrated from next lint to ESLint CLI for future Next.js 16 compatibility
  • Updated ESLint configuration to exclude build artifacts (.open-next, .wrangler, drizzle)

0.1.0 - 2025-10-10

Added

  • Initial release of Templator
  • Next.js 15 with App Router and React 19
  • TypeScript with strict mode
  • Tailwind CSS 4 with shadcn/ui components
  • Dark mode support with next-themes
  • Authentication system:
    • NextAuth v5 with Drizzle adapter
    • Email/password authentication
    • Email verification flow
    • Password reset flow
    • Session management with JWT
  • Role-Based Access Control (RBAC):
    • Three roles: user, editor, admin
    • Permission system with role gates
    • Protected routes with middleware
  • Database:
    • Drizzle ORM with Neon PostgreSQL
    • Type-safe queries
    • Migrations with Drizzle Kit
    • Edge-compatible architecture
  • Email system:
    • React Email templates
    • Mock mode for development
    • Resend integration for production
    • Email templates for auth, blog, contact, newsletter
  • Feature modules:
    • Blog system with draft/publish workflow
    • Contact form with Server Actions
    • Newsletter with double opt-in
    • Profile management
    • User management (admin only)
  • Pages:
    • Landing page with Hero, Features, CTA
    • Pricing page
    • Contact page
    • Blog listing and post pages
    • Dashboard with role-based sections
    • Authentication pages (login/register/forgot-password)
  • Developer Experience:
    • Turbopack for fast development
    • ESLint + Prettier configured
    • Code quality scripts (lint, format, typecheck)
  • Deployment:
    • Cloudflare Workers support with OpenNext
    • Wrangler configuration
    • Environment variables setup
  • Documentation:
    • Comprehensive README
    • Architecture guide
    • RBAC system docs
    • Tech stack rationale
    • Setup instructions
    • Component reference
    • Code examples
    • AI workflow guide
    • Recipe patterns