Files
clawfort/openspec/changes/archive/2026-02-13-p03-languages-ml-tm/proposal.md

2.0 KiB

Why

ClawFort currently publishes content in a single language, which limits accessibility for regional audiences. Adding multilingual delivery now improves usability for Tamil and Malayalam readers while keeping the current English workflow intact.

What Changes

  • New Capabilities:
    • Persist the fetched articles locally in database.
    • Generate Tamil and Malayalam translations for each newly created article using Perplexity.
    • Store translated variants as language-specific content items linked to the same base article.
    • Add a language selector on the landing page to switch article rendering language.
    • Persist user language preference in browser storage (local storage or cookie) and restore it for returning users.
  • Frontend:
    • Add visible language switcher UI on the one-page experience.
    • Render hero and feed content in selected language when translation exists.
  • Backend:
    • Extend content generation flow to request and save multilingual outputs.
    • Serve language-specific content for existing API reads.

Capabilities

New Capabilities

  • article-translations-ml-tm: Create and store Tamil and Malayalam translated content variants for each article at creation time.
  • language-aware-content-delivery: Return and render language-specific article fields based on selected language.
  • language-preference-persistence: Persist and restore user-selected language across sessions for returning users.

Modified Capabilities

  • None.

Impact

  • Code: Backend aggregation/storage flow, API response handling, and frontend rendering/state management will be updated.
  • APIs: Existing read endpoints will need language-aware response behavior or language selection input handling.
  • Dependencies: Reuses Perplexity integration; no mandatory new external provider expected.
  • Infrastructure: No deployment topology changes.
  • Environment: Uses existing Perplexity configuration; may introduce optional translation toggles/settings later.
  • Data: Adds translation data model/fields linked to each source article.