vigneshksaithal/use-reddit-api

Use Reddit API

All code must follow the Coding Principles in AGENTS.md (functional, minimal, readable, modular).

Available imports

import { reddit, context } from '@devvit/web/server'

Context variables

| Variable | Type | Available when | |----------|------|----------------| | context.userId | string \| undefined | User is logged in | | context.postId | string \| undefined | Inside a post | | context.subredditId | string | Always | | context.subredditName | string | Always |

Always guard optional context before use (see api-route skill for guard helpers).

Common operations

Get current user

const user = await reddit.getCurrentUser()
if (!user) {
  return c.json({ status: 'error', message: 'Not logged in' }, 400)
}
const username = user.username

Get current subreddit

const subreddit = await reddit.getCurrentSubreddit()

Submit a custom post

const post = await reddit.submitCustomPost({
  subredditName: context.subredditName!,
  title: 'My Post Title',
  entry: 'default',  // matches entrypoint key in devvit.json
})
// post.id is the new post ID (e.g. "t3_abc")

Submit a comment

await reddit.submitComment({
  postId: context.postId!,
  text: 'Great job! 🎉',
})

Set user flair

await reddit.setUserFlair({
  subredditName: context.subredditName!,
  username: user.username,
  text: 'Champion 🏆',
})

Navigation response (menu items)

When a menu item handler needs to redirect the user to a post:

app.post('/internal/menu/create-game', async (c) => {
  const post = await reddit.submitCustomPost({
    subredditName: context.subredditName!,
    title: 'New Game',
    entry: 'default',
  })
  return c.json({
    navigateTo: `https://reddit.com/r/${context.subredditName}/comments/${post.id}`,
  })
})

Constraints

• Reddit API calls are server-side only — never from client Svelte code
• 30-second request timeout applies to all operations
• Error handling follows the api-route skill pattern (try/catch, instanceof Error)

Checklist before finishing

• [ ] Tests written FIRST in src/server/__tests__/ using bun:test and devvit-mocks
• [ ] All Reddit API calls are in server code (src/server/)
• [ ] context.userId and context.postId guarded before use
• [ ] Response uses standard shape from api-route skill
• [ ] Menu item handlers return { navigateTo: url } when redirecting
• [ ] bun run test passes with zero failures