rescript-remix-blog-template

rescript-remix-blog-template is an open-source blog starter that combines the ReScript language with the Remix web framework, MDX for content, Tailwind CSS for styling, and Vercel for deployment. It takes Markdown/MDX files as input and produces a multi-page blog with a post list and individual post pages. The template is aimed at developers who want to build a blog using ReScript and Remix together, and it also serves as a learning resource for ReScript bindings to Remix.

What is rescript-remix-blog-template?

rescript-remix-blog-template is a blog template written in ReScript, built on the Remix web framework, and using MDX for content authoring. It reads MDX files from a content directory and renders a blog with a home page listing recent posts and individual post pages. The project is hosted on GitHub and includes a live demo deployed on Vercel, making it easy to preview and deploy.

Key Features

• ReScript + Remix stack — Written in ReScript, using the community-maintained rescript-remix bindings (from tom-sherman/rescript-remix) instead of plain JavaScript.
• MDX content — Blog posts are written as MDX files; the index route reads MDX files from the content directory and lists them as recent posts.
• Tailwind CSS — Styling is handled by Tailwind, allowing utility-first customization of the layout.
• Predefined layout — Includes a header, cover image area, and post list showing title, excerpt, and author.
• Vercel deployment — The template includes a live demo on Vercel and is structured to deploy as a serverless Remix app.
• Troubleshooting documentation — The README documents real integration issues (e.g., MDX routing and LoaderFunction bindings) and how they were resolved, useful for developers hitting the same problems.

Who is it for?

• ReScript developers who want a working example of ReScript in a full-stack Remix application.
• Blog authors who prefer writing content in MDX and want a minimal, customizable starter.
• Developers learning Remix who want a concrete codebase that shows Remix conventions (routes, loaders) implemented in ReScript.

What can you do with it?

• Launch a personal blog: Use the template as-is, replace the MDX posts with your own, and deploy to Vercel.
• Learn ReScript bindings: The repository includes bindings for Remix and documents the process of writing custom bindings when existing ones are missing (e.g., LoaderFunction).
• Extend the template: Because it uses Tailwind and Remix routes, you can add new pages or modify the design without fighting the framework.

How does it work?

After cloning the repository, run yarn to install dependencies, then yarn res:dev to compile ReScript and yarn dev to start the Remix dev server. The index route loads MDX files from a content directory and renders a list of posts; individual post routes display the full MDX content.

FAQ

Is rescript-remix-blog-template free?

Yes, the source code is publicly available on GitHub under an open-source license. There are no paid tiers or usage fees.

Does the template support MDX?

Yes, MDX is the primary content format. The README describes how MDX routing was implemented after initial issues with the rescript-remix bindings.

Can I deploy this to Vercel?

The template is designed for Vercel deployment and includes a live demo on Vercel. The Remix framework has native Vercel support.

What is the recommended workflow for adding a new post?

Currently, the template reads MDX files from a folder, so adding a new post means creating a new .mdx file and rebuilding the project. The README notes that the Remix team suggests using a database for content, but the template intentionally keeps posts as local MDX for simplicity.