Block Blast Hack

A modern landing page and web application built with Next.js 14, featuring a beautiful UI design and optimized for global performance using Cloudflare Pages deployment.

🚀 Features

• Modern Stack: Built with Next.js 14 App Router and TypeScript
• Beautiful UI: Powered by NextUI, Tailwind CSS, and Framer Motion
• Internationalization: Multi-language support with next-intl
• Analytics Integration: Plausible Analytics and Google Analytics support
• Dark Mode: Seamless dark/light mode switching with next-themes
• SEO Optimized: Built-in sitemap generation and meta tags
• Global CDN: Cloudflare Pages deployment for optimal performance
• State Management: Zustand for efficient state handling

📋 Prerequisites

• Node.js 18.x or later
• pnpm (recommended) or npm
• Git
• Cloudflare account (for deployment)

🛠️ Installation

1. Clone the repository:

git clone https://github.com/yourusername/bbhack-git.git
cd bbhack-git

2. Install dependencies:

pnpm install

3. Set up environment variables:

cp .env.example .env.local

Configure the following in your .env.local:

• NEXT_PUBLIC_GA_ID: Google Analytics ID
• NEXT_PUBLIC_SITE_URL: Your site URL

🚀 Development

Start the development server:

pnpm dev

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

🏗️ Build & Deploy

Local Build

pnpm build
pnpm start

Cloudflare Pages Deployment

1. Preview deployment:

pnpm preview

2. Production deployment:

pnpm deploy

📁 Project Structure

├── app/                 # Next.js 14 app directory
│   ├── [locale]/       # Internationalization routes
│   ├── api/            # API routes
│   └── layout.tsx      # Root layout
├── components/         # React components
│   ├── ui/            # UI components
│   └── shared/        # Shared components
├── lib/               # Utility functions
├── messages/          # Internationalization messages
├── public/            # Static assets
├── styles/           # Global styles
└── types/            # TypeScript definitions

🌍 Internationalization

The project supports multiple languages. Add new translations in the messages directory.

🎨 UI Customization

• Tailwind CSS for styling
• NextUI components
• Custom theme configuration in tailwind.config.ts
• Dark mode support via next-themes

📈 Analytics

• Plausible Analytics integration
• Google Analytics support
• Custom event tracking

🔒 Security

• Environment variables protection
• API route protection

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Support

For support, please open an issue in the GitHub repository.