Social posts module for PhoenixKit — user-generated posts with threaded comments, likes/dislikes, tags, Pinterest-style boards, media galleries, @mentions, view tracking, and scheduled publishing.

Not a blog/CMS. For long-form articles — Markdown/.phk content, slugged pages, versioned and multilingual publishing — use PhoenixKit's built-in Publishing module. PhoenixKitPosts is for social, feed-style posting: posts, likes, boards, mentions, and threaded comments.

• Elixir ~> 1.18
• PhoenixKit ~> 1.7 (host application)
• Phoenix LiveView ~> 1.1

Add to your parent PhoenixKit app's mix.exs:

{:phoenix_kit_posts, "~> 0.1.0"}

Run mix deps.get. The module appears in the admin panel automatically via PhoenixKit's auto-discovery — no additional configuration required.

• Post management — Create, update, delete, publish posts with draft/public/unlisted/scheduled status
• Threaded comments — Nested comments with unlimited depth, plus like/dislike tracking per comment
• Like and dislike system — One-per-user enforcement with denormalized counter caches
• Tag system — Hashtag parsing and auto-slugification
• Group collections — Pinterest-style boards for organizing posts with ordering
• Media attachments — Multiple files per post with position-based ordering and featured image support
• User mentions — Track @mentions within posts
• View tracking — Track post views with denormalized counters
• Scheduled publishing — Automatic publishing at a specified time via Oban workers
• Admin UI — LiveView-based admin pages for posts, groups, and settings

# Create a post
{:ok, post} = PhoenixKitPosts.create_post(user_uuid, %{
  title: "My First Post",
  content: "Hello world!",
  type: "post",
  status: "draft"
})

# Publish a post
{:ok, post} = PhoenixKitPosts.publish_post(post)

# Schedule a post for later
{:ok, post} = PhoenixKitPosts.schedule_post(post, ~U[2026-04-01 12:00:00Z])

# Like a post (one per user, enforced by unique constraint)
{:ok, like} = PhoenixKitPosts.like_post(post.uuid, user_uuid)

# Tag a post
PhoenixKitPosts.add_tags_to_post(post, ["elixir", "phoenix"])

# Create a group and organize posts
{:ok, group} = PhoenixKitPosts.create_group(user_uuid, %{
  name: "Travel Photos",
  description: "My adventures"
})
PhoenixKitPosts.add_post_to_group(post.uuid, group.uuid)

# Attach media
PhoenixKitPosts.attach_media(post.uuid, file_uuid, position: 1)

# Mention a user
PhoenixKitPosts.add_mention_to_post(post.uuid, mentioned_user_uuid)

# Query posts
posts = PhoenixKitPosts.list_public_posts(page: 1, per_page: 20)
post = PhoenixKitPosts.get_post_by_slug("my-first-post")

Settings are managed through the PhoenixKit Settings API and can be configured via the admin UI at /admin/settings/posts.

Generate docs locally with:

mix docs

mix deps.get        # Install dependencies
mix test            # Run tests
mix format          # Format code
mix credo --strict  # Static analysis
mix dialyzer        # Type checking
mix precommit       # All of the above

MIT — see LICENSE for details.

• GitHub
• PhoenixKit