This site is built with Remix!
It's deployed automagically with Vercel!
From your terminal:
pnpm install
pnpm dev
This starts your app in development mode, rebuilding assets on file changes.
The documentations for all TanStack projects except for React Charts
are hosted on https://tanstack.com, powered by this Remix app.
In production, the markdown doc pages are fetched from the GitHub repos of the projects, but in development they are read from the local file system.
Follow these steps if you want to edit the doc pages of a project (in these steps we'll assume it's TanStack/form
) and preview them locally :
- Create a new directory called
tanstack
.
mkdir tanstack
- Enter the directory and clone this repo and the repo of the project there.
cd tanstack
git clone git@github.com:TanStack/tanstack.com.git
git clone git@github.com:TanStack/form.git
Note
Your tanstack
directory should look like this:
tanstack/
|
+-- form/
|
+-- tanstack.com/
Warning
Make sure the name of the directory in your local file system matches the name of the project's repo. For example, tanstack/form
must be cloned into form
(this is the default) instead of some-other-name
, because that way, the doc pages won't be found.
- Enter the
tanstack/tanstack.com
directory, install the dependencies and run the app in dev mode:
cd tanstack.com
pnpm i
# The app will run on https://localhost:3000 by default
pnpm dev
- Now you can visit http://localhost:3000/form/latest/docs/overview in the browser and see the changes you make in
tanstack/form/docs
.
Note
The updated pages need to be manually reloaded in the browser.
Warning
You will need to update the docs/config.json
file (in the project's repo) if you add a new doc page!