OnePubli.sh

Reads structured content from Notion databases via the official Notion API, extracts text, links, and metadata from database properties, and transforms the content into platform-agnostic intermediate representation. Uses Notion's block-based document model to preserve hierarchical structure while normalizing formatting across heterogeneous database schemas. Maintains bidirectional sync state to track which content has been published and prevent duplicate distribution.

Accepts normalized content payloads and routes them to multiple social media platforms (Twitter, LinkedIn, Facebook, Instagram) via their respective APIs. Implements platform-specific adapters that handle authentication (OAuth 2.0), rate limiting, character limits, and media attachment constraints. Orchestrates sequential or parallel publishing across platforms with error handling and rollback capabilities if individual platform publishes fail.

Analyzes extracted Notion content and automatically truncates, reformats, or adapts text to meet platform-specific constraints (Twitter's 280 character limit, LinkedIn's optimal post length, Instagram's caption length). Detects and removes unsupported formatting (Notion's inline code blocks, colored text, custom fonts) and converts them to plain text equivalents. Implements heuristics to preserve semantic meaning while fitting platform constraints (e.g., intelligent truncation that breaks at sentence boundaries rather than mid-word).

Implements a freemium access model where users can publish up to a monthly limit (e.g., 50 posts/month) without payment, with usage tracking via database records tied to user accounts. Enforces rate limits and quota checks before each publish action. Provides upgrade prompts when users approach or exceed free tier limits, with transparent pricing for paid tiers that unlock higher publishing volumes, scheduled publishing, and advanced features.

Implements OAuth 2.0 authentication flow for user login (email/password or social login) and separate OAuth 2.0 flow for Notion workspace authorization. Stores encrypted access tokens for Notion API with refresh token rotation to maintain long-lived access without requiring re-authorization. Implements scope-based permissions to request only necessary Notion database read access, following principle of least privilege.

Generates visual previews of how content will appear on each target social platform before publishing, simulating platform-specific rendering (character limits, line breaks, link previews, emoji rendering). Displays side-by-side previews for multiple platforms to help users identify formatting issues or content truncation. Uses platform-specific CSS and layout rules to approximate native rendering without requiring actual platform APIs.

Maintains a database record of all published content with metadata (publish timestamp, target platforms, content text, Notion source ID, publish status). Enables users to view past publishes, identify which Notion entries have been published, and prevent accidental duplicate publishing of the same content. Provides search and filtering by date, platform, or source Notion database.

Accepts multiple content items (from Notion database query or manual selection) and publishes them to target platforms in configurable batch mode. Supports sequential publishing (one at a time with delays to avoid rate limiting) or parallel publishing (concurrent requests to multiple platforms). Implements exponential backoff and retry logic for failed publishes, with detailed error reporting per item and platform.

Enables users to define queries against their Notion databases to select which content to publish (e.g., 'all entries with status=Ready', 'entries created in last 7 days', 'entries with tag=urgent'). Implements Notion's filter syntax or simplified UI-based query builder. Supports filtering by database properties (text, select, date, checkbox) and allows users to save filter presets for repeated use.