Scratch
Scratch is a simple tool for "vibe writing". It can be used with any editor to build static websites using MDX files and react components.
Get Started
To get started, clone this repository and run
npm install
npm run build
# add scratch cli to your PATH
npm link
Creating a new scratch project
Now, try creating a new scratch writing project
# create a new scratch project in myproj/
scratch create myproj
Writing with scratch
Use your favorite AI code editor (e.g. Windsurf or neovim + Claude Code) to create and edit files in myproj/website.
When you want a new component to help you communicate a concept, just ask your handy LLM assistant for help building it.
You can follow along locally by running the following command in your scratch project directory:
npm run dev
Publishing with scratch
When you're ready to publish, run the following command in your scratch project directory:
npm run build
Scratch projects are compiled into static websites that can be hosted anywhere. You can find the compiled files in the dist folder inside of your scratch project directory.
Examples
What can you create with scratch? Anything you can express in words and React components!
You can find a few examples on the scratch website
