😀🏘️ EmojiTown

A delightful emoji-matching puzzle game built with Next.js and TypeScript. Match three similar emojis to create higher-level emojis and aim for the highest score!

🚀 Installation

Prerequisites

• Node.js v18.0.0 or higher
• npm v9.0.0 or higher
• Git

Setup Instructions

1. Generate a Personal Access Token (PAT): - Go to GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) - Click "Generate new token (classic)" - Select scopes: repo (Full control of private repositories) - Copy the generated token immediately (you won't see it again!)

2. Clone the repository using the token:

bash
git clone https://[YOUR_PAT]@github.com/yourusername/EmojiTown.git
cd EmojiTown

Or store the credentials permanently:

bash
git config --global credential.helper store
git clone https://github.com/yourusername/EmojiTown.git
Enter your GitHub username and use the PAT as the password

2. Install dependencies:

bash
npm install

3. Build the production version:

bash
npm run build

4. Start the server:

bash
For development with hot reloading
npm run dev
For production
npm start

The game will be available at http://localhost:3000 (or the next available port if 3000 is in use).

Running on a Headless Server

1. Install PM2 for process management (optional but recommended):

bash
npm install -g pm2

2. Start the server with PM2:

bash
pm2 start npm --name "emojitown" -- start

3. Configure PM2 to start on boot (optional):

bash
pm2 startup
pm2 save

Environment Variables

Create a .env.local file in the root directory with the following variables:

env
Port to run the server on (default: 3000)
PORT=3000
Host to bind to (default: 0.0.0.0)
HOST=0.0.0.0

🎮 Game Features

• Match three similar emojis to create higher-level emojis
• Dynamic day/night title that changes based on time
• Smooth animations and visual feedback
• High score system with top 100 scores
• Responsive design that works on all devices

🛠️ Development

Tech Stack

• Next.js 14
• TypeScript
• Tailwind CSS
• React

Available Scripts

• npm run dev - Start development server
• npm run build - Build production version
• npm start - Start production server
• npm run lint - Run ESLint
• npm run type-check - Run TypeScript type checking

📝 License

MIT License - feel free to use and modify as you wish!

🤝 Contributing

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