Unity Snippets Next.js 🎮

Next.js Framework - Unity Snippets Edition

A Unity-optimized wrapper for Next.js that provides enhanced support for Unity WebGL development and Unity Snippets projects.

🚀 Features

• 100% Next.js Compatible: Drop-in replacement for standard Next.js
• Unity WebGL Optimized: Pre-configured headers and settings for WebGL
• Unity Detection: Built-in utilities for detecting Unity WebGL environments
• Simple Integration: Easy helpers for Unity-specific Next.js configuration
• Maintained: Based on latest Next.js with Unity Snippets enhancements

📦 Installation

npm install @unity-snippets/next
# or
yarn add @unity-snippets/next
# or  
pnpm add @unity-snippets/next

🎯 Usage

Basic Usage (Drop-in Replacement)

// Replace 'next' with '@unity-snippets/next'
import { NextRequest, NextResponse } from '@unity-snippets/next/server';
import dynamic from '@unity-snippets/next/dynamic';
// ... all other Next.js imports work the same

Unity-Specific Features

const unityNext = require('@unity-snippets/next');

// Check if running in Unity WebGL environment
console.log('Is Unity WebGL?', unityNext.unity.isUnityWebGL());

// Get Unity Snippets version info
console.log('Unity Snippets Next.js:', unityNext.unity.version);
console.log('Is Unity Fork?', unityNext.unity.isUnitySnippetsFork);

Unity-Optimized Next.js Config

// next.config.js
const unityNext = require('@unity-snippets/next');

/** @type {import('next').NextConfig} */
const nextConfig = unityNext.unity.createUnityConfig({
  // Your existing Next.js config
  experimental: {
    appDir: true,
  },
  // Unity optimizations are automatically applied:
  // - Cross-Origin headers for WebGL
  // - Optimized CSS and React settings  
  // - Unity-specific performance optimizations
});

module.exports = nextConfig;

🎮 What's Included

Unity WebGL Optimizations

• Pre-configured CORS headers for Unity WebGL
• Cross-Origin-Embedder-Policy and Cross-Origin-Opener-Policy headers
• Optimized build settings for WebGL performance

Unity Detection Utilities

• unity.isUnityWebGL() - Detect Unity WebGL runtime
• Unity instance detection (UnityEngine, unityInstance, gameInstance)
• Environment-specific optimizations

Developer Experience

• Unity Snippets branding and version info
• Enhanced CLI with Unity-specific messaging
• Compatible with all Next.js tools and ecosystem

🔧 Requirements

• Node.js 18.18.0 or later
• React 18.2.0 or later
• Same requirements as standard Next.js

📚 Compatibility

This package is a thin wrapper around the official Next.js package and maintains 100% API compatibility. You can use all Next.js features, plugins, and tools as normal.

Base Next.js Version: 15.5.4+ (automatically updated) Unity Snippets Version: 15.5.3

🤝 Contributing

This package is part of the Unity Snippets project. Contributions welcome!

• Repository: https://github.com/Unity-Snippets/unity-snippets
• Issues: https://github.com/Unity-Snippets/unity-snippets/issues
• Website: https://unitysnippets.com

📄 License

MIT License - Same as Next.js

Made with 💜 by Unity Snippets
Empowering Unity developers with modern web tools 🎮✨