Documentation Index
Fetch the complete documentation index at: https://docs.beatsquares.com/llms.txt
Use this file to discover all available pages before exploring further.
RSS Feed Available: Subscribe to our RSS feed to get automatic updates about new releases.
Recent Updates
New Features
- Introduce static segment type for blueprint-fixed templating: Create templates that remain consistent and don’t change over time.
- Add org-level CDN skip hosts for newsletter image rewriting: Choose which hosts to exclude when updating newsletter images, improving customization.
- Cap presigned audio download URL expiry to 7 days: Ensure audio download links remain valid for up to a week for better security.
New Features
-
Podcast segments — structured dialogue UI and backend sync
Easily manage podcast segment dialogue with a user-friendly interface. -
Add webhook notification delivery for published podcast audio
Get instant notifications when your podcast audio is published or integrate with other tools like Contentful. -
Add dynamic poll option add/remove controls in WhatsApp editor
Effortlessly add or remove poll options in WhatsApp messages. -
Generate audio preview for highlighted text segment
Listen to a quick audio preview of any text you highlight.
New Features
- WhatsApp Polls You can now create and manage polls, with easy setup, editing, and sharing options,
- Newsletters curation on demand We have introduced buttons to manually trigger curation blueprints for newsletters.
- We have upgraded our system management tools to ensure smoother and more consistent updates.
- Your draft scripts are now saved when you switch between different segments and message variations.
- We fixed an issue with RSS feeds so that images are now correctly displayed.
- Selecting text in data views is now smoother, without interruptions from pop-up updates.
- We’ve improved content processing to ensure all segments display correctly.
Bug Fixes & Stability
- We have stabilized the content curation tool to ensure it works reliably, even if some data is missing.
Bug Fixes & Stability
- Fixes an issue where the audio briefing screen gets stuck on “Generating” after errors occur.
New Features
- Add Deep Review command for context-aware code reviews: Enhances code review by providing context-specific insights.
- Soft-delete media item segments with restore, generation guards, and related UI: Allows you to temporarily remove media segments and restore them if needed.
- Allow uploading new logos when creating an organization: You can now upload logos directly when setting up a new organization.
- Email article import cleanup and LLM model upgrade to GPT-5: Improves email article import quality with the latest AI model.
- Split LLM prompts into system and user messages: Improves clarity by separating system and user prompts.
- Fixes issues with some source specific press release processing.
- Resolves RSS feed fetching problems to prevent task failures.
Bug Fixes & Stability
- Fixes an error that occurs when the mood is not set in podcast creation.
New Features
- Unify action status, optimistic updates, and Redis-driven cache invalidation: Streamlines updates and improves performance.
- Persist segment generation and publish snapshots for segment analytics: Keeps track of segment changes for better analytics.
- PostHog instrumentation with org/square context and editor events: Enhances tracking of user interactions.
- Scraper monitoring system with run logging, health checks, and Slack alerts: Improves reliability with better monitoring and alerts.
- Streaming audio preview with ElevenLabs SSE and MediaSource API: Provides real-time audio previews.
- Define content source config schema with Firecrawl support: Standardizes content source setup.
- Org settings content source CRUD UI and stacked sources pipeline: Simplifies managing content sources.
- HTTP conditional fetch with ETag/Last-Modified caching: Speeds up data fetching by using caching.
- RSS feed ingestion with Firecrawl enrichment for truncated items: Enhances RSS feed data with additional context.
- Store WhatsApp variant images per tab instead of a single segment field: Organizes images more efficiently.
- Align WhatsApp send controls with in-flight delivery and invalidate client cache on finalize: Ensures message delivery is smooth and up-to-date.
- Replace media item full-replace calls with atomic per-segment endpoints: Improves media update efficiency.
- Fixes disappearing newsletter segment images after script edits.
- Resolves WhatsApp message delays caused by processing issues.
- Fixes WhatsApp feeds with image support.
- Fix fact viewer for WhatsApp segments via unified source content sidebar.
New Features
- Define content source configuration schema with Firecrawl support: Simplifies content source management.
- Ingest RSS feeds with Firecrawl enrichment for truncated items: Adds extra details to RSS feeds.
- Add organization settings UI for content sources, stacked sources pipeline, and feed test connection: Makes it easier to manage and test content sources.
- Replace full media item updates with atomic per-segment script endpoints: Enhances media update efficiency.
- Show the fact viewer for WhatsApp segments via the unified source content sidebar: Provides more context for WhatsApp content.
- Use conditional HTTP requests with ETag/Last-Modified caching to skip unchanged feeds: Speeds up feed updates by skipping unchanged content.
- Ignores deleted sources during data processing to prevent errors.
- Fixes disappearing newsletter segment images after script edits.
New Features
- Add retry logic for transient Gemini empty response errors in podcast TTS: Improves podcast text-to-speech reliability by retrying failed requests.
- UX Enhancement: Edit/Save Whatsapp message: Makes editing and saving WhatsApp messages smoother.
New Features
- Curation agent enhancements — cross-square memory, article exclusion, fetch limit configuration, and curation settings UI: Improves content curation with more control and settings.
- Show error message when podcast generation fails with structured error handling and banner component: Provides clear error messages for podcast issues.
- Create media item as archived during auto-generation, unarchive after segment generation: Manages media items more effectively during creation.
- Refactor and optimize server actions and navigation performance: Speeds up server processes and navigation.
- Prevent overview and formatting segments from accepting content assignments: Ensures content is assigned correctly.
- Remove segment title from newsletters and podcasts and unify segment editor UI: Simplifies the segment editing interface.
- Unify segment edit buttons and refactor segment editor UI: Streamlines the editing process.
- Fixes loss of verified state when saving segments without changes.
- Resolves repeated MongoDB migrations on startup.
- Fixes new data sources not being recognized by the scheduler.
New Features
- Add CurationConfig to squares with cross-square memory, article exclusion, and fetch limit: Enhances content curation with more flexible settings.
New Features
- Add button to create empty WhatsApp messages from scratch: Allows you to start new WhatsApp messages easily.
- Upload finished podcast audio files to Bunny Storage CDN: Ensures podcasts are stored securely and efficiently.
- Backend logging audit — request context, state transitions,: Enhances logging for better tracking and debugging.
- Defer Claude Agent SDK config import and improve: Optimizes configuration loading for better performance.
- Fixes timeout issues during long podcast generation.
- Resolves image flickering in the newsletter editor.
- Adds a timeout for failed segment generation to improve reliability.
Bug Fixes & Stability
- Fixes timeout issues during long podcast generation to ensure smoother audio processing.
Bug Fixes & Stability
- Ensures imported content types are correctly saved to metadata for better data management.
New Features
- Slack notifications and auto-generation for articles: Keeps you informed with automatic notifications and article generation.
- Optimize FORMATTING segment generation performance: Speeds up segment formatting.
- Add FRONTEND_URL to worker environment in staging and production: Improves environment configuration for better performance.
- Increase Tagesspiegel curation agent memory to 2 days and include all segments (except manual): Enhances memory usage for better content curation.
- Fix timezone settings
- Fixes selection count issues in ContentPickerDialog.
- Removes unnecessary logging from RSS feed processing.
- Improves update verification by confirming with the server.
- Resolves disk space issues by cleaning up unused data.
- Fixes segment verification and rapid generation issues.
- Resolves media item panel freezing and React errors.
- Fixes client-side crashes and race conditions in the newsletter editor.
- Resolves generation tracking and update conflicts.
- Resets script references when exiting WhatsApp message editing.
Bug Fixes & Stability
- Fixes interface flashing and empty lines in text-to-speech for a smoother user experience.
New Features
- Add custom cron scheduling support in ScheduleSettings: Provides flexible scheduling options.
- Add LLM-based article facet classification for some data sources: Enhances article categorization with AI.
- Add playback speed control to segment preview: Lets you adjust playback speed for better control.
New Features
- Segment generation UX with progress bar, error state, verification, and atomic content updates: Improves user experience with clear progress indicators.
- Dynamic ElevenLabs voice resolution via API with TTL cache: Enhances voice selection for text-to-speech.
- Add retry logic for overview segment generation when segments are not yet verified: Increases reliability by retrying unverified segments.
- Increase strategy timeouts from 5 to 10 minutes across different services: Allows more time for complex strategies to complete.
- Refactor scraping module — extract pipeline stages, fix Sentry issues, and add input truncation: Improves scraping reliability and performance.
- Refactor S3 importer to handler pattern and fix duplicate article metadata processing: Enhances data import efficiency and accuracy.
- Add retry logic for transient Firecrawl API errors: Improves reliability by retrying failed API requests.
- Fixes progress bar issues and adds error state polling for segment generation.
- Resolves concurrency issues in text-to-speech processing.
- Fixes Google TTS errors and adds retries for temporary issues.
- Fixes errors in event title extraction for better data accuracy.
Bug Fixes & Stability
- Fixes issues with WhatsApp article suggestions to ensure timely and accurate recommendations.
New Features
- Add configurable newsletter editor styles and custom buttons to square settings: Customizes the editor to fit your needs.
- Allow newsletter AI segment styling through blueprint: Enhances newsletter design with AI-driven styling.
- Media items pagination on square page: Makes browsing media items easier with pagination.
- Integrate Podigee upload for podcast episodes: Simplifies podcast publishing with direct uploads.
- Replace string-based strategy heuristics with explicit metadata fields: Improves strategy accuracy with better data handling.
New Features
- Add unified segment editing components, shared segment infrastructure (hooks, context provider), and utility libraries for segment refactoring: Simplifies segment editing with a unified system.
- Refactor segment components to a unified editing provider (newsletter, podcast, WhatsApp): Streamlines editing across different platforms.
- Centralize segment status logic and improve verification checks: Ensures segment status is consistent and accurate.
- Improve WhatsApp message validation for live editing: Enhances real-time editing reliability.
- Migrate newsletter, podcast, and WhatsApp to unified SegmentEditor and providers: Unifies the editing experience across platforms.
- Enhance segment editing (escape handling, button loading states, ImageUpload, square settings UI): Improves editing features for a better user experience.
- Improve HTML rendering in newsletter edit view and simplify loading components: Enhances visual consistency and performance.
- Rename newsletter and podcast components for consistency (e.g. PodcastEmbed → PodcastPublished): Ensures component names are clear and consistent.
- Update segment editor and media item routing; remove deprecated component files: Cleans up and organizes the editing system.
New Features
- Enable WhatsApp cross-posting and scheduling for RSS-WhatsApp squares: Expands content reach with cross-posting capabilities.
- Allow squares to opt out of auto-suggested media items: Provides more control over media suggestions.
- Optimize article processing LLM usage and remove dead code: Improves processing efficiency and cleans up the system.
- Fixes duplicate analytics and metadata issues.
- Resolves segment generation failures for WhatsApp messages.
New Features
- Add Contentful webhook integration documentation: Provides clear instructions for integrating webhooks.
- Add square-level API key support for TTS providers: Enhances security with API key management.
- Add podcast metadata generation and segment editing UI improvements: Enhances podcast management and editing.
- Add segment labels to help users identify segments in the UI: Makes segment identification easier.
- Allow podcasts to publish with empty segments: Provides flexibility in podcast publishing.
- Improve segment/podcast editing feel with optimistic updates: Enhances editing responsiveness.
- Fixes issues with CDN setup and optional configurations.
- Resolves disappearing text issues in podcast titles.
- Changes validation to skip empty segments for better accuracy.
- Fixes audio preview issues in podcast segments.
Bug Fixes & Stability
- Fixes timeout issues during audio preview generation in podcast segments for smoother playback.
Bug Fixes & Stability
- Fixes issues with e-paper signals to ensure accurate filtering.
New Features
- Use short URLs for WhatsApp posts: Makes sharing easier with shorter links.
- Implement multi-separator segment divider system to distinguish news vs other content: Enhances content organization.
- Add SVG support to TipTap editor: Expands editing capabilities with SVG support.
- Bunny CDN origin-pull for Gmail-safe newsletter images: Ensures newsletter images are compatible with Gmail.
- Show podcast generating status without page reload: Provides real-time status updates.
- Replace drag-and-drop with move up/down buttons for segment reordering: Simplifies segment reordering.
- Make gemini-2.5-pro-preview-tts the default voice model: Improves text-to-speech quality with a new default model.
- Simplify auth by removing refresh tokens: Streamlines authentication processes.
- Fixes data import issues and duplicate data problems.
- Properly resets user sessions after logout to prevent access issues.
- Fixes podcast voice mixing and adjusts volume settings.
New Features
- Implement Signal Provider Architecture and optimize token usage for article curation: Enhances content curation efficiency.
- Add S3 importer for e-paper XML and analytics data: Improves data import capabilities.
- Allow users to revert podcast and newsletter to draft state: Provides flexibility to revert changes.
- Add generating visual to WhatsApp posts while generation is in progress: Indicates ongoing content generation.
- Implement unified content model for strategy inputs: Standardizes content input for strategies.
- Centralized Escape Handling System: Improves system reliability with centralized error handling.
- Refactor Segment Action Controls into single logic source: Simplifies action control management.
- Invalidate React Query cache when user session changes: Keeps data fresh by clearing outdated cache.
- Prevent duplicate segment generation requests with client and server deduplication: Reduces unnecessary processing.
- Change WhatsApp scheduling minimum time to 5 minutes: Provides more flexibility in scheduling.
- Fixes image update issues in WhatsApp posts.
- Filters out invalid WhatsApp sessions from scheduling.
- Prevents placeholder titles from causing interface issues.
- Fixes thumbnail and segment option issues.
- Resolves navigation issues when switching organizations.
- Fixes newsletter segment icon display and improves image handling.
- Fixes media panel behavior and scrolling issues.
- Resolves timeout errors for specific spiders with better configuration.
New Features
- S3 Data Import: Import e-paper XML and analytics data directly from S3 buckets for automated content ingestion
- Edit Published Content: Return to editing mode for published newsletters and podcasts to fix typos or make corrections
- WhatsApp Scheduling: Reduced minimum scheduling time from 30 minutes to 5 minutes for faster testing and publishing
- WhatsApp Generation Indicator: Clear visual feedback when WhatsApp posts are being generated
- Keyboard Navigation: Improved escape key behavior for consistent modal dismissal
- Background Scrolling: Media item overlay now allows background list scrolling for easier navigation
- Fixed WhatsApp posts showing outdated images after editing
- Fixed duplicate podcast segment generation requests
- Fixed newsletter icons not displaying in editor
- Fixed user session not updating after login with different account
- Fixed organization switching from within media items
- Improved Curation Agent response size handling
New Features
- Unified Content Model: Strategies now work seamlessly with Articles, Events, and Press Releases through a single unified interface—no more format-specific configurations
- Free-form Text Generation: Strategy Builder now supports unstructured text output for use cases that don’t require structured data validation
- Mixed Content Support: Strategies now handle different content types (articles, press releases) within the same segment without errors
- Consistent Newsletter Styling: Improved visual consistency across newsletter segments with standardized image formats and typography
- Expanded Podcast Strategies: Added new podcast segment strategies for editorial commentary, analysis, and news summaries
- Improved reliability of the Curation Agent during content generation
- Fixed validation errors in automated workflows
Bug Fixes & Stability
- Fixes an error in the PreToolUse hook by adding necessary fields for better functionality.
New Features
- WhatsApp Cross-posting: Post content to multiple WhatsApp channels simultaneously—create once, distribute everywhere
- Google Gemini Voice: Added Google Gemini as a text-to-speech option for podcast generation
- Design System: Introduced centralized design tokens for consistent colors, typography, and spacing
- Smarter Curation: Curation Agent now tracks previously published articles to avoid recommending duplicates
- Reliable Scheduling: Fixed timing drift in automated scraping and generation schedules
- Newsletter Image Handling: Improved image support in manual segments including inline icons
- Cleaner UI: Refined header styling and improved login page design
- Fixed empty newsletter segments rendering as “none”
- Improved health monitoring endpoints for better uptime tracking
New Features
- Automated Newsletter Generation: Schedules can now trigger full newsletter generation automatically using the Curation Agent
- Segment Reordering: Drag and drop to reorder or remove segments in newsletters and podcasts
- Article Quantity Controls: Define minimum and maximum articles per segment in blueprints
- Faster Page Loads: Migrated to client-side rendering with React Query for significantly improved responsiveness
- Real-time WhatsApp Status: See actual delivery status (Pending, Sent, Failed) with automatic polling
- Dynamic Scraping Schedules: Configurable per-data-source scraping times instead of fixed system schedules
- New RSS Data Sources: Added multiple regional news sources for content aggregation
- Fixed organization switching not updating displayed content
- Fixed strategy processing errors
- Improved memory management in Curation Agent
New Features
- Curation Agent: AI-powered article selection that analyzes homepage position, analytics data, and article content to recommend the best content for your newsletters
- Strategy Updates: Enhanced newsletter strategies with improved formatting and field handling
New Features
- WhatsApp RSS Feed: Published WhatsApp messages now available as RSS feed for external integrations
- Changelog Collection: Improved tracking of generated and published content snapshots for evaluation
- WhatsApp Session Handling: Enhanced session caching and automatic cleanup of failed sessions
- Fixed newsletter template not displaying during editing
- Fixed segment generation UI not updating immediately
- Fixed image width inconsistencies in manual segments
- Improved server health monitoring to ignore expected 4xx responses
New Features
- Fact Viewer: Added fact viewer functionality for newsletters and podcasts, allowing users to track names, places, and figures between source material and generated content with interactive highlighting
- Overview Segment Type: Introduced new Overview segment type for generating content summaries (like podcast intros) that use other segments as inputs
- Data Source Filtering: Implemented individual filtering for data sources per square, enabling more granular control over content sources
- Podcast Enhancements: Updated ElevenLabs TTS model to eleven_v3, added voice selection (Jane and Otto), and fixed HTTP/2 protocol errors in podcast audio streaming
- WhatsApp Strategy Migration: Migrated WhatsApp article generation to use Full Strategy (analysis + generation) in Strategy Builder, consolidating multiple LLM calls into a single strategy execution
- Content Selection: Unified article selection interface across all square types, now using the WhatsApp “Add article” modal for newsletters and podcasts, with support for Events and Press Releases
- Podcast UI Redesign: Updated podcast generation flow to match newsletter UI with blueprint concept, segment variants, verification workflow, and block-based editor
- Scheduled Scraping: Added scrapers to scheduled scraping tasks for automated content collection
- Performance Optimization: Fixed Strategy Builder out of memory errors by optimizing Sentry SDK configuration and sampling rates
New Features
- Blueprint-Based Newsletter Generation: Introduced segment blueprint system allowing users to define fixed content structures with AI and manual segments
- RSS Integration: Added support for importing articles from full-text RSS feed with Media RSS support
- Email Data Sources: Implemented email-based data sources using SendGrid Inbound Parse, allowing editors to send content via email to populate squares
- Home Scraper: Added homepage scraping system with importance scoring for extracting articles from news homepages
- Segment Verification: Added ability to set individual segments to “Verified” status in newsletter and podcast workflows
- WhatsApp Event Images: Extended Strategy Builder to support image handling for WhatsApp event posts
- Regional Sources: Added scrapers for events and press releases from various government sources
- Newsletter UI Redesign: Completely redesigned newsletter generation flow with block-based editor, segment variants, and improved editing experience
- Square Settings Page: New unified settings page for squares with blueprint configuration, scheduling options, and improved organization
- Dashboard Navigation: Simplified navigation with direct access to media item lists and improved square switching
- Media Item Updates: Refactored media item update system to use granular actions, reducing complexity and improving state management
- Health Endpoints: Added standardized
/healthendpoints across all backend services for better monitoring and observability - Spider Organization: Reorganized scrapers into client and category-specific folders for better maintainability
- Memory Leak Fix: Resolved Strategy Builder memory leak caused by unclosed LLM HTTP clients
- Task Time Limits: Increased time limits for Events and Press Releases processing tasks to handle larger datasets
- Type Annotations: Fixed type annotation inconsistencies for strategy parameters across the codebase
- Firecrawl Retries: Added retry mechanism for Firecrawl 502 errors to improve scraping reliability
- Validation Errors: Fixed various validation errors in fact checking, pipeline processing, and strategy configuration
New Features
- Strategy Builder: Released a completely new pipeline system that allows developers and business users to quickly iterate on agentic workflows for content transformtations. Initial release supports newsletters as a first pipeline.
- Session Management: Implemented caching and webhook system for WhatsApp sessions
- Performance: Eliminated N+1 queries in media item script changelog with batched snapshots
- Article Deduplication: Fixed critical issue switching from External ID to URL for uniqueness
- WhatsApp Channel Naming: Resolved text replacement bug when creating new channels
- UI Content Overflow: Fixed popup content overflow in WhatsApp editor “Create an Article” dialog
- Deployment Issues: Resolved strategy builder deployment version problems
- Load Redirects: Fixed redirect behavior after content generation
- Service Exceptions: Resolved 500 errors caused by excessive requests when opening squares
- Environment Configuration: Fixed LangSmith target environment settings
New Features
- Celery Beat Scheduling: Add suggestions to Celery Beat schedule
- Manual Triggers: Trigger Event & Press Release suggestions by Square ID
- Smart Suggestion System: Develop concept for Articles, Press Releases, and Events
- RSS Integration: Added support for automated RSS feed spiders
- Scraping Endpoint: Create endpoint to trigger scraping with limit logic
- Event Suggestions: Create task for event-based content suggestions
- General Scrapers: Implement new scrapers for event and press release content
- Channel Support: Added scrapers for expanding to new distribution channels
- Content Archiving: Save raw HTML and image metadata for better reference
- System Monitoring: Monitor failures for celerybackend_cleanup
- Resource Management: Handle unclosed client sessions more gracefully
- Channel Expansion: Enhanced support for new content delivery channels
- Deployment Cleanup: Remove staging Celery Flower deployment
- Validation Error: Fixed
ValidationError: 1 validation error for MeInfo - UI Layout: Corrected misaligned padding/indent in category list (checkbox tree)
Stay Updated
Get Notified- Subscribe to our RSS feed for automatic updates