a minimalist starter kit for designers like me who want to create a modern React + Tailwind site but don't want to have to debug five fucking files just to figure out what the hell is colouring that button.
- Minimalist architecture
- Global styles handled in one place (
index.css), with Tailwind used directly in components — no scattered theme files or cryptic utility wrappers - Root styling that won't fight against what you want to do at the page level
| Date | Name | Remarks |
|---|---|---|
| 2026-01-21 | Jojo Vargas | Added a button to the repo \ |
| 2025-12-16 | Jojo Vargas | Improved mobile menu and overall cleaner |
| 2025-06-26 | Jojo Vargas | It has come to my attention that Sanity is a content management / delivery platform, so I renamed this project |
| 2025-06-25 | Jojo Vargas | Initial project setup and documentation |
This is a blank canvas for you to create your layouts.
It’s relatively unencumbered, so you can be as flexible as you need to be. Edit global styles in index.css (including colours, hyperlink hover interactions, etc.) and style components or one-off elements using Tailwind utility classes.
- 🌗 Dark mode toggle (via
@shadcn/ui) - 📱 Mobile-responsive navbar with sliding sheet menu
- 🎨 Easy-to-edit theme with OKLCH color definitions
- 🧼 Clean file structure with no opinionated folder hell
- 🔨 shadcn-ui components, functional and highly customisable
- The header is positioned
absoluteand will overlap your content — so don’t forget to offset your firstdivaccordingly (e.g., withmt-30). - There are comments throughout the codebase to help you navigate and tweak things easily.
- Built with React Router, Tailwind, and ShadCN — but you can easily swap parts out.
If you haven’t already, install Node.js (recommended: LTS version).
Then install Yarn globally:
npm install --global yarnFollow the instructions on GitHub to clone this repository.
On your terminal, run this:
yarn installYou can start the development server using:
yarn devHead to http://localhost:5173 — this is Vite’s default dev server address, but yours may vary.
Basic accessibility is supported out of the box via semantic HTML and shadcn/ui's focus-visible patterns. ARIA labels are included in interactive elements like the menu trigger. Further improvements (e.g., keyboard navigation across the sheet menu) are welcome contributions!
If you have any questions or bug reports, please feel free to raise an issue or reach out to me through the links on my profile.
With love,
Jojo Vargas
Urban tech researcher at ETH Zurich
With a hatred of overengineered boilerplates
And a desire to style everything manually
