@souporserious.com
Design / Systems / React
Building https://www.renoun.dev/
Building https://www.renoun.dev/
Join us on Discord if you have any questions discord.com/invite/7Mf4x...
Join the souporserious Discord Server!
Check out the souporserious community on Discord - hang out with 8 other members and enjoy free voice and text chat.
discord.com
October 16, 2025 at 6:31 PM
Join us on Discord if you have any questions discord.com/invite/7Mf4x...
It's a culmination and testament to React's ability to schedule work efficiently. You can now install one package and start writing accurate, high-quality documentation with a best-in-class developer and user experience.
October 16, 2025 at 6:23 PM
It's a culmination and testament to React's ability to schedule work efficiently. You can now install one package and start writing accurate, high-quality documentation with a best-in-class developer and user experience.
It's been almost five years since React Server Components were announced and three years since we could practically use them.
I could not have built www.renoun.dev without React.
I could not have built www.renoun.dev without React.
October 16, 2025 at 6:23 PM
It's been almost five years since React Server Components were announced and three years since we could practically use them.
I could not have built www.renoun.dev without React.
I could not have built www.renoun.dev without React.
Annotations for code blocks usually require writing regexes to target specific source code and don't stay in sync easily. Working on something new using inline JSX comments. Highly flexible, declarative, and exposes annotations as renderers you can do whatever you want with.
October 12, 2025 at 8:27 PM
Annotations for code blocks usually require writing regexes to target specific source code and don't stay in sync easily. Working on something new using inline JSX comments. Highly flexible, declarative, and exposes annotations as renderers you can do whatever you want with.
renoun has taken a long time to build because I run into every single issue it's trying to solve for the documentation site. It feels good to finally talk about now though, I'm really happy with where the API is. The changelog is quite the history of where it has been so far 😄 renoun.dev/changelog
renoun - The Documentation Toolkit for React
The renoun toolkit uses your React framework to keep documentation polished, in sync, and on brand.
renoun.dev
October 10, 2025 at 9:50 PM
renoun has taken a long time to build because I run into every single issue it's trying to solve for the documentation site. It feels good to finally talk about now though, I'm really happy with where the API is. The changelog is quite the history of where it has been so far 😄 renoun.dev/changelog
It's fully composable through React Server components that work with any bundler and ships everything you need in one package: syntax highlighting, support for multiple themes, advanced API references, table of contents, and a full-featured file system utility that works with each component.
October 10, 2025 at 8:22 PM
It's fully composable through React Server components that work with any bundler and ships everything you need in one package: syntax highlighting, support for multiple themes, advanced API references, table of contents, and a full-featured file system utility that works with each component.
Thank you, Josh! 😊
October 8, 2025 at 10:31 PM
Thank you, Josh! 😊
Excited to officially launch renoun.dev 🚀
This has been years in the making to deliver a focused set of components, hooks, and utilities in React for building great documentation exactly to your standards that always stay in sync.
This has been years in the making to deliver a focused set of components, hooks, and utilities in React for building great documentation exactly to your standards that always stay in sync.
renoun - The Documentation Toolkit for React
The renoun toolkit uses your React framework to keep documentation polished, in sync, and on brand.
renoun.dev
October 8, 2025 at 5:50 PM
Excited to officially launch renoun.dev 🚀
This has been years in the making to deliver a focused set of components, hooks, and utilities in React for building great documentation exactly to your standards that always stay in sync.
This has been years in the making to deliver a focused set of components, hooks, and utilities in React for building great documentation exactly to your standards that always stay in sync.
Is Promise.all necessary when returning an array of promises as children or will Suspense/SuspenseList essentially optimize this?
I also noticed iterator maps work as well which is so nice! Would be great to document this as well.
I also noticed iterator maps work as well which is so nice! Would be great to document this as well.
July 31, 2025 at 9:41 PM
Is Promise.all necessary when returning an array of promises as children or will Suspense/SuspenseList essentially optimize this?
I also noticed iterator maps work as well which is so nice! Would be great to document this as well.
I also noticed iterator maps work as well which is so nice! Would be great to document this as well.
Documenting inversion of control could help here instead of baking it in:
const transition = useTransition()
<Button transition={transition}>...</Button>
Then if it's not defined the Button works as normal.
const transition = useTransition()
<Button transition={transition}>...</Button>
Then if it's not defined the Button works as normal.
July 31, 2025 at 9:36 PM
Documenting inversion of control could help here instead of baking it in:
const transition = useTransition()
<Button transition={transition}>...</Button>
Then if it's not defined the Button works as normal.
const transition = useTransition()
<Button transition={transition}>...</Button>
Then if it's not defined the Button works as normal.
Yeah, it's super limited and tedious to manage this way. Hopefully we'll get first-class support for classes and more advanced overloading someday.
July 16, 2025 at 6:38 PM
Yeah, it's super limited and tedious to manage this way. Hopefully we'll get first-class support for classes and more advanced overloading someday.
You can kind of accomplish this using assertions on getters and then "this" parameter for methods www.typescriptlang.org/play/#code/M...
TS Playground - An online editor for exploring TypeScript and JavaScript
The Playground lets you write TypeScript or JavaScript online in a safe and sharable way.
www.typescriptlang.org
July 16, 2025 at 12:28 AM
You can kind of accomplish this using assertions on getters and then "this" parameter for methods www.typescriptlang.org/play/#code/M...
This will be a much nicer onboarding experience overall, thank you for contributing all of these fixes! 🙏
June 25, 2025 at 8:06 PM
This will be a much nicer onboarding experience overall, thank you for contributing all of these fixes! 🙏
So exciting! I felt like this was always a huge hinderance to adopting MDX in App Router.
June 24, 2025 at 9:41 PM
So exciting! I felt like this was always a huge hinderance to adopting MDX in App Router.
Reminds me of this vv.xyz/ideas/12b00e...
Mastery Hides Labor
At clarity, effort vanishes. Friction is gone. Genius looks obvious. That invisibility is the work.
vv.xyz
May 28, 2025 at 4:10 PM
Reminds me of this vv.xyz/ideas/12b00e...
Made a small CLI that does exactly this that makes it a little easier github.com/souporseriou...
GitHub - souporserious/packlink: A simple and reliable way to test pnpm packages locally without publishing.
A simple and reliable way to test pnpm packages locally without publishing. - souporserious/packlink
github.com
May 25, 2025 at 5:56 PM
Made a small CLI that does exactly this that makes it a little easier github.com/souporseriou...
The new Chinese American Bear EP. It's slowed down versions of their previous songs, but it's good. open.spotify.com/album/0rCKf5...
Waaaaaaaah!!!
Chinese American Bear · EP · 2025 · 6 songs
open.spotify.com
May 23, 2025 at 11:02 PM
The new Chinese American Bear EP. It's slowed down versions of their previous songs, but it's good. open.spotify.com/album/0rCKf5...
I don't think that's exclusive to RSC, we've always needed to guard those calls with something like "typeof document !== undefined" if it is initially server rendered.
May 22, 2025 at 4:49 PM
I don't think that's exclusive to RSC, we've always needed to guard those calls with something like "typeof document !== undefined" if it is initially server rendered.
Love this! I've wanted to explore variants for posts like a free version and then more in-depth paid version. It's more work obviously, but thinking there would be more incentive to go deeper.
April 11, 2025 at 7:38 AM
Love this! I've wanted to explore variants for posts like a free version and then more in-depth paid version. It's more work obviously, but thinking there would be more incentive to go deeper.
Just implemented this on one of my projects and it cleaned up so much, thank you!
March 25, 2025 at 2:44 AM
Just implemented this on one of my projects and it cleaned up so much, thank you!
More on structures here ts-morph.com/manipulation...
ts-morph - Structures
ts-morph.com
March 25, 2025 at 2:35 AM
More on structures here ts-morph.com/manipulation...
Yeah, sorry tsxmod isn't really helpful yet. You can code golf with a chat app, but if I understand what you're after you probably want to use structures and prune out any info you don't care about. Whipped up something to start with here stackblitz.com/edit/stackbl...
ts-morph navigation - StackBlitz
Starter project for Node.js, a JavaScript runtime built on Chrome's V8 JavaScript engine
stackblitz.com
March 25, 2025 at 2:32 AM
Yeah, sorry tsxmod isn't really helpful yet. You can code golf with a chat app, but if I understand what you're after you probably want to use structures and prune out any info you don't care about. Whipped up something to start with here stackblitz.com/edit/stackbl...
never finished this project, but you can play with ts-morph here fairly quick to get an idea www.tsxmod.com
www.tsxmod.com
March 24, 2025 at 8:53 PM
never finished this project, but you can play with ts-morph here fairly quick to get an idea www.tsxmod.com
you want ts-morph ts-morph.com/navigation/
ts-morph - Navigating the AST
ts-morph.com
March 24, 2025 at 8:52 PM
you want ts-morph ts-morph.com/navigation/