Since the AI-assisted development era began, I have had dozens and dozens of requests to share my .cursor/rules for writing TypeScript code.
I was hoping to rely on community resources for this. There are dozens of directories springing up to document different folks' Cursor rules.
But my brief explorations into these community directories have been disappointing. The rules that are there are low-quality, underwritten, low on code examples, and not widely applicable.
So I'm here to give you my Cursor rules, such as they are. I don't think they're perfect. They are not as battle-tested as I would like.
But I do think that we, as a community, need to start coming to some consensus as to what makes a good cursor rule. So I'm hoping that this article will kick off that discussion.
I've designed these rules so that they don't focus on specific frameworks or libraries. Instead, they are just focused on the TypeScript language.
This means that anywhere you use TypeScript, these rules should benefit you.
They fall into a few different buckets:
as const to enums, preferring import type to import { type }, readonly propertiesResult over try/catch, allowing any inside generic functions, discriminated unions, return types on functionsnoUncheckedIndexedAccesspackage.jsonYou can download them here.
There are two kinds of cursor rules that come to mind.
The first kind of cursor rules are workspace rules. These are rules which are checked into Git and versioned alongside your code.
This type of cursor rule lets you do a few things:
The second kind of cursor rule are rules which are tailored for you.
These are rules which are not checked into Git, but live in your IDE.
They are rules which are specific to your coding style, your preferences and your workflow. They let you:
Share this article with your friends
Here's a quick .cursor/rules addition you can make for handling return types in TypeScript.
# Return Types
When declaring functions on the top-level of a module,
declare their return types. This will help future AI
assistants understand the function's purpose.
```ts
const myFunc = (): string => {
return "hello";
};
```
One exception to this is components which return JSX.
No need to
TypeScript announced a full rewrite of TypeScript in Go. In testing, this rewrite has achieved a 10x speedup in some repositories - and up to 15x in others.
TypeScript 5.8's new erasableSyntaxOnly flag enforces pure type annotations by disabling enums, namespaces, and parameter properties.
TypeScript is coming to Node 23. Let's break down what that means.
Learn how to extract the type of an array element in TypeScript using the powerful Array[number] trick.
Learn how to publish a package to npm with a complete setup including, TypeScript, Prettier, Vitest, GitHub Actions, and versioning with Changesets.
