Skip to content

Commit 0330e73

Browse files
Weekly updates feb 2 2026 (#44)
Resolving weekly thread of feedback
1 parent 67fe09f commit 0330e73

File tree

17 files changed

+157
-71
lines changed

17 files changed

+157
-71
lines changed

docs/capabilities/server/overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ Allows you to build apps where the end user can upload custom images to Reddit's
1616

1717
Allows you to query information from Reddit such as comments, posts and upvotes. Limited to installation scope of the application.
1818

19-
## [Scalable storage (Redis)](./redis.mdx)
19+
## [Data storage (Redis)](./redis.mdx)
2020

21-
Allows you to store app data in a scalable database, free of charge. Limited to the installation scope of the application.
21+
Allows you to store app data in a key-value database, free of charge. Limited to the installation scope of the application.
2222

2323
## [Scheduler](./scheduler.md)
2424

docs/capabilities/server/reddit-api.mdx

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,31 @@ Here's how to obtain a reference to the Reddit client
3636
</TabItem>
3737
</Tabs>
3838

39+
## Reddit Thing IDs
40+
41+
Reddit uses prefixed IDs (called "things") to identify different types of content:
42+
43+
| Prefix | Type | Example | Description |
44+
| ------ | ---- | ------- | ----------- |
45+
| `t1_` | Comment | `t1_abc123` | A comment on a post or reply to another comment |
46+
| `t2_` | User | `t2_xyz789` | A Reddit user account |
47+
| `t3_` | Post | `t3_def456` | A post |
48+
| `t4_` | Message | `t4_ghi012` | A private message |
49+
| `t5_` | Subreddit | `t5_jkl345` | A subreddit community |
50+
51+
These IDs are returned by API methods and used when referencing specific content:
52+
53+
```ts
54+
// Get a post by its full ID
55+
const post = await reddit.getPostById('t3_abc123');
56+
57+
// Get a comment by its full ID
58+
const comment = await reddit.getCommentById('t1_xyz789');
59+
60+
// A comment's parentId can be either a post (t3_) or another comment (t1_)
61+
const parentId = comment.parentId; // 't3_abc123' or 't1_def456'
62+
```
63+
3964
## Example usage
4065

4166
### Submitting a post

docs/changelog.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -239,4 +239,4 @@ We'd love to hear about your experience with Devvit Web! Join the conversation i
239239
In addition to Devvit Web, release 0.12 also adds:
240240

241241
- **Post data** - [Post data](./capabilities/server/post-data.mdx) allows you to add data to your post when you submit it so that you can retrieve and use in your app without an additional Redis call.
242-
- **Splash screen** - Having a compelling first screen of your app is one of the most important indicators of good post engagement. Every submitPost will come with a default per-post [splash screen](./capabilities/server/splash-screen.mdx) you can customize.
242+
- **Splash screen** - Having a compelling first screen of your app is one of the most important indicators of good post engagement. Every submitPost will come with a default per-post splash screen.

docs/earn-money/payments/payments_overview.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,3 @@ You can use the sandbox to build and test payments, but before you can publish y
1919
- Accept and comply with our [Earn Terms](https://redditinc.com/policies/earn-terms) and [Earn Policy](https://www.redditinc.com/policies/earn-policy).
2020

2121
All products will be reviewed by the Developer Platform team to ensure compliance with our content policy. Products are approved during the app review process after you publish your app.
22-
23-
:::note
24-
Payment functionality is supported on [Devvit Blocks](../../capabilities/blocks/overview.md) only. [Devvit Web](../../capabilities/devvit-web/devvit_web_overview.mdx) is currently not supported.
25-
:::

docs/examples/template-library.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,13 @@ Here are some starter projects and templates for your Devvit projects
1212

1313
- [Phaser starter](https://github.com/reddit/devvit-template-phaser) - a feature-rich HTML5 game framework for building 2D games in the browser. It includes preinstalled libraries for Devvit, Vite, Phaser, Express, and TypeScript. This template is good for handling physics, animations, input, sound, and asset management.
1414

15+
- [Unity starter](https://github.com/reddit/devvit-template-unity) - a template for building games with Unity. Includes setup for WebGL builds and integration with Devvit's server-side capabilities.
16+
17+
- [GameMaker starter](https://github.com/reddit/devvit-template-gamemaker) - a template for building games with GameMaker. Includes setup for HTML5 exports and integration with Devvit's server-side capabilities.
18+
1519
- [Hello world](https://github.com/reddit/devvit-template-hello-world/tree/main) - a simple template to build a counter app with no frameworks or opinions.
1620

21+
1722
## Devvit Blocks
1823

1924
[Devvit Blocks](../capabilities/blocks/overview.md) lets you build applications that run inside of a Reddit post, using Reddit's own design system: optimized for performance and cross-platform compatibility.
Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Learn how your game can be featured across Reddit and reach thousands of players
1212

1313
## What is featuring?
1414

15-
Whether youre prototyping an early version of your first Reddit game or launching a polished experience to a wide audience, you have an opportunity to be featured. Our mission is to help developers grow by connecting their work with the Reddit users that will love it. Featuring selections are curated by our team and refreshed regularly to spotlight innovation, polished play, and player engagement.
15+
Whether you're prototyping an early version of your first Reddit game or launching a polished experience to a wide audience, you have an opportunity to be featured. Our mission is to help developers grow by connecting their work with the Reddit users that will love it. Featuring selections are curated by our team and refreshed regularly to spotlight innovation, polished play, and player engagement.
1616

1717
Note that our top featuring slots are reserved for games that are of professional quality, as well as games that see exceptional engagement as they grow (CTR, dwell times, positive user engagement, retention).
1818

@@ -34,15 +34,15 @@ Games that see organic growth are also likely to be scouted by our team for feat
3434

3535
Reddit features games and developers across multiple discovery surfaces to help players find new favorites:
3636

37-
- **Games Feed.** The Games Feed showcases playable experiences directly within Reddit. When featured, games are rotated into a list of games that is algorythmically served to users visiting the feed.
37+
- **Games Feed.** The Games Feed showcases playable experiences directly within Reddit. When featured, games are rotated into a list of games that is algorithmically served to users visiting the feed.
3838

39-
![Featured games](../../assets/featured_games.png)
39+
<img src={require('../../assets/featured_games.png').default} alt="Featured games" width="400" />
4040

4141
- **Community Drawer.** Our lefthand drawer provides an easy access point for any redditor to see a mix of recently played games and curated popular games.
4242

43-
![Community drawer web](../../assets/featured_cd_web.png)
43+
<img src={require('../../assets/featured_cd_web.png').default} alt="Community drawer web" width="300" />
4444

45-
![Community drawer mobile](../../assets/featured_cd_mobile.png)
45+
<img src={require('../../assets/featured_cd_mobile.png').default} alt="Community drawer mobile" width="300" />
4646

4747
- **Home Feed boosting.** One selected game per week is given an extra algorithmic boost in user home feeds, reaching broad audiences.
4848
- **r/GamesOnReddit.** The curated [r/GamesOnReddit](https://www.reddit.com/r/GamesOnReddit/) banner highlights new and trending games for Reddit players.
@@ -52,11 +52,11 @@ Reddit features games and developers across multiple discovery surfaces to help
5252

5353
## Featuring tiers
5454

55-
| Tier | Description | Featuring Spots | Who Its For | Level of Polish | Approximate Impressions\* |
55+
| Tier | Description | Featuring Spots | Who It's For | Level of Polish | Approximate Impressions\* |
5656
| --------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------- | -------------------------------------------------- | ------------------------------------------- |
5757
| **Distributed** | Games get initial exposure on r/GamesOnReddit featuring | Cross-posted by Reddit, pinned banner on r/GamesOnReddit | Developers seeking first players | Early builds of launched apps | Thousands |
5858
| **Promoted** | Polished games selected to gain more visibility and engagement | Games Feed listing, more visibility in r/GamesOnReddit launch pad | Developers ready to expand their reach | Polished, working seamlessly across all platforms | Tens of thousands of impressions |
59-
| **Highlighted** | High-performing games that drive significant player engagement | Games Feed top positions, added to Community Drawer recently played or one of the popular slots | Developers with highly polished, iterated games | Highly polished, optimized for scale and retention | Hundreds of thousands of impressions |
59+
| **Highlighted** | High-performing games that drive significant player engagement | Games Feed top positions, added to Community Drawer "recently played" or one of the popular slots | Developers with highly polished, iterated games | Highly polished, optimized for scale and retention | Hundreds of thousands of impressions |
6060
| **Hero** | Top-tier, standout games featured broadly across Reddit | Games Feed highlight, featured in Community Drawer, Home Feed highlight | Developers with flagship-quality games | Pro quality, high retention and engagement | Millions to tens of millions of impressions |
6161

6262
\*This is a rough estimate and does not reflect what any particular game will reach at this tier.
@@ -69,7 +69,7 @@ Games can be promoted to our highest featuring tiers if they see exceptional eng
6969

7070
In order to promote a game, we need to ensure the experience for redditors meets certain quality criteria. To be featured at any level you must have:
7171

72-
- **A compelling first screen.** Your game must have a custom [splash screen](https://developers.reddit.com/docs/capabilities/server/splash-screen).
72+
- **A compelling first screen.** Your game must have a custom first screen.
7373
- **Cross platform support.** Your game's viewport must be accessible and clean on both mobile and desktop platforms.
7474
- **Self-explanatory design.** Anyone should be able to click into your post and have the context needed to learn, play, or participate.
7575
- **Responsive design.** All screens should be visible within fullscreen, mobile, and desktop. Avoid unnecessary scrolls. Scrolling within inline webviews is prohibited.
@@ -78,7 +78,7 @@ In order to promote a game, we need to ensure the experience for redditors meets
7878

7979
## Featuring considerations
8080

81-
Our goal is to feature games that feel great to play and reflect Reddits creative spirit. With each featuring tier, the quality of featured apps becomes more stringent. Beyond the basic featuring requirements, we want to see:
81+
Our goal is to feature games that feel great to play and reflect Reddit's creative spirit. With each featuring tier, the quality of featured apps becomes more stringent. Beyond the basic featuring requirements, we want to see:
8282

8383
- **Standout user experience.** Fast, intuitive, and responsive gameplay across devices.
8484
- **Design and polish.** Cohesive visuals, appealing splash screens, and optimized mobile layouts.
@@ -91,6 +91,7 @@ Our goal is to feature games that feel great to play and reflect Reddit’s crea
9191

9292
## Celebrating your app
9393

94-
Games that reach featured tiers often see thousands of daily players and dedicated community followings. When your game is featured, youll receive promotional visibility through banners, feeds, and subreddit posts, as well as the opportunity to share your success across social channels and developer communities.
94+
Games that reach featured tiers often see thousands of daily players and dedicated community followings. When your game is featured, you'll receive promotional visibility through banners, feeds, and subreddit posts, as well as the opportunity to share your success across social channels and developer communities.
9595

9696
See stories about successful games like [Honk](https://developers.reddit.com/docs/blog/honk) and [Syllocrostic](https://www.reddit.com/r/Devvit/comments/1n0vn97/reddit_has_acquired_syllacrostic/), which Reddit acquired after successful featuring.
97+

docs/guides/tools/logs.md

Lines changed: 34 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,45 @@ Stream log events from your installed app to your command line to troubleshoot y
44

55
## Create logs
66

7-
Any logs sent to `console` will be available via `devvit logs` for installed apps. For example, `console.log()`, `console.info()` and `console.error()` will produce logs with timestamps as expected.
7+
Use `console.log()`, `console.info()`, and `console.error()` in your server code to create logs. View them with `devvit logs` for installed apps, or add `--verbose` to include timestamps.
88

9-
The following example creates a basic app that simply creates a single log.
9+
The following example creates a basic app with a menu action that creates a log when clicked.
1010

11-
```typescript title="main.tsx"
12-
import { Context, Devvit } from '@devvit/public-api';
11+
```json title="devvit.json"
12+
{
13+
"$schema": "https://developers.reddit.com/schema/config-file.v1.json",
14+
"name": "app-name",
1315

14-
Devvit.addMenuItem({
15-
location: 'post',
16-
label: 'Create a log!',
17-
onPress: (event, context) => {
18-
console.log('Action called!');
19-
context.ui.showToast(`Successfully logged!`);
16+
"server": {
17+
"dir": "dist/server",
18+
"entry": "index.cjs"
2019
},
21-
});
20+
"permissions": {
21+
"reddit": true
22+
},
23+
"menu": {
24+
"items": [
25+
{
26+
"label": "Create a log!",
27+
"location": "subreddit",
28+
"endpoint": "/internal/log-action",
29+
"forUserType": "moderator"
30+
}
31+
]
32+
}
33+
}
34+
```
2235

23-
export default Devvit;
36+
```typescript title="server/index.ts"
37+
router.post("/internal/log-action", async (_req, res): Promise<void> => {
38+
console.log("log-action");
39+
res.json({
40+
showToast: {
41+
text: "Log action",
42+
appearance: "success",
43+
},
44+
});
45+
});
2446
```
2547

2648
## Stream logs
@@ -49,13 +71,6 @@ You should now see logs streaming onto your console:
4971

5072
To exit the streaming logger, enter `CTRL + c`.
5173

52-
Currently, `console.log` calls will only stream when they are run from the server (not the client).
53-
54-
:::note
55-
56-
Custom post apps use a client-side runtime to speed up execution, so `console.log` calls won't always show up in Devvit logs or Devvit playtest commands. However, these calls will show up in other dev tools (like Chrome) when viewing the app during a playtest.
57-
58-
:::
5974

6075
## Historical logs
6176

docs/guides/tools/playtest.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ The auto-generated playtest subreddit is created for you by u/devvit-dev-bot. Th
3737
- Allows reddit admins to join your subreddit
3838

3939
:::note
40-
If you need help, run `devvit playtest -help` for additional information.
40+
If you need help, run `devvit playtest --help` for additional information.
4141
:::
4242

4343
## View logs

sidebars.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -300,7 +300,6 @@ const sidebars: SidebarsConfig = {
300300
type: "category",
301301
label: "Splash Screens",
302302
items: [
303-
"capabilities/server/splash-screen",
304303
"capabilities/server/launch_screen_and_entry_points/splash_migration",
305304
],
306305
},

versioned_docs/version-0.11/playtest.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ The auto-generated playtest subreddit is created for you by u/devvit-dev-bot. Th
3737
- Allows reddit admins to join your subreddit
3838

3939
:::note
40-
If you need help, run `devvit playtest -help` for additional information.
40+
If you need help, run `devvit playtest --help` for additional information.
4141
:::
4242

4343
## View logs

0 commit comments

Comments
 (0)