Installation

Prerequisites

• Node.js 18.17 or later
• npm, pnpm, or yarn

1. Clone the repository

git clone https://github.com/your-org/sassify.git my-app
cd my-app/sassify-app

2. Install dependencies

npm install --legacy-peer-deps

The --legacy-peer-deps flag is required because React Three Fiber v9 has peer dependency conflicts with React 18. This is safe — it doesn't change what gets installed, only how peer conflicts are resolved.

3. Set up environment variables

cp .env.example .env.local

Open .env.local and fill in the required values. At minimum you need:

NEXT_PUBLIC_APP_URL=http://localhost:3000

4. Start the development server

npm run dev

Open http://localhost:3000 in your browser.

Project structure

sassify-app/
├── content/              # MDX blog posts and docs
│   ├── blog/
│   └── docs/
├── src/
│   ├── app/              # Next.js App Router pages
│   ├── components/
│   │   ├── effects/      # Cursor, scroll progress, toasts
│   │   ├── layout/       # Navbar
│   │   ├── sections/     # Landing page sections
│   │   └── ui/           # Reusable UI components
│   ├── hooks/            # Custom React hooks
│   ├── lib/              # Utilities (cn, mdx)
│   └── providers/        # ThemeProvider, SmoothScrollProvider
├── public/
└── tailwind.config.ts

Available scripts

Troubleshooting

Port 3000 already in use

fuser -k 3000/tcp && npm run dev

Module not found errors after adding packages

rm -rf node_modules .next && npm install --legacy-peer-deps