website-starter

An opinionated starting point for new websites: **Next.js (App Router) + TypeScript

• Tailwind CSS v4 + framer-motion**, with an AI build workflow baked in.

Create a new site from this template

Uses degit — copies the files with no git history:

npx degit MadReal/website-starter my-new-site
cd my-new-site
npm install
npm run dev

Then git init your new project when you're ready.

What's included

• framer-motion, pre-wired. Reusable primitives in src/components/motion/: FadeIn, Reveal, Stagger / StaggerItem, and a MotionProvider that respects prefers-reduced-motion globally.
• AI workflow in CLAUDE.md: use the global ui-ux-pro-max skill for design decisions and pull component inspiration from 21st.dev/community/components.
• Demo home page showing the motion primitives in use.

Scripts

npm run dev     # start dev server
npm run build   # production build
npm run start   # serve the production build
npm run lint    # eslint

Notes

• No shadcn/ui. 21st.dev components are used as inspiration and rebuilt with plain Tailwind — don't assume @/components/ui/* exists.
• Built on Next.js 16 / React 19 / Tailwind v4.