An open API service indexing awesome lists of open source software.

https://github.com/thoriqdharmawan/meme-generator

๐Ÿ“ฑ A fun and easy-to-use Meme Generator app built with React Native. create and customize memes instantly! ๐Ÿ˜„
https://github.com/thoriqdharmawan/meme-generator

react-native react-native-gesture-handler react-native-reanimated

Last synced: 13 days ago
JSON representation

๐Ÿ“ฑ A fun and easy-to-use Meme Generator app built with React Native. create and customize memes instantly! ๐Ÿ˜„

Awesome Lists containing this project

README

        

# ๐Ÿ˜Ž Meme Generator

**๐ŸŽจ Create hilarious memes with ease! ๐ŸŽญ**

A powerful and intuitive React Native application for creating, editing, and sharing memes with your friends and social media.

[![React Native](https://img.shields.io/badge/React%20Native-0.75-blue?style=for-the-badge&logo=react)](https://reactnative.dev)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)
[![iOS](https://img.shields.io/badge/iOS-Compatible-black?style=for-the-badge&logo=apple)](https://developer.apple.com/ios/)
[![Android](https://img.shields.io/badge/Android-Compatible-green?style=for-the-badge&logo=android)](https://developer.android.com/)

---

## ๐ŸŒŸ Features

- ๐Ÿ–ผ๏ธ **Rich Image Editor** - Add text, stickers, and effects to your images
- ๐Ÿ“ฑ **Cross-Platform** - Works seamlessly on both iOS and Android
- โšก **Fast Refresh** - See your changes instantly during development
- ๐ŸŽฏ **Touch Controls** - Intuitive drag, resize, and rotate interactions
- ๐Ÿ“ **Snap Guides** - Perfect alignment for professional-looking memes
- โ†ฉ๏ธ **Undo/Redo** - Never lose your creative progress
- ๐ŸŽจ **Modern UI** - Beautiful and responsive design

## ๐Ÿ“ฑ Screenshots

### ๐Ÿค– Android

Android Screenshot

### ๐ŸŽ iOS

iOS Screenshot

## ๐Ÿš€ Quick Start

> **๐Ÿ“‹ Prerequisites**: Ensure you have completed the [React Native Environment Setup](https://reactnative.dev/docs/set-up-your-environment) guide.

### ๐Ÿ”ง Installation

1. **Clone the repository**

```bash
git clone https://github.com/thoriqdharmawan/meme-generator/
cd MemeGenerator
```

2. **Install dependencies**

```bash
# Using npm
npm install

# OR using Yarn
yarn install
```

3. **iOS Setup** (macOS only)
```bash
# Install CocoaPods dependencies
cd ios && pod install && cd ..
```

### ๐Ÿƒโ€โ™‚๏ธ Running the Application

#### ๐Ÿ“ฑ Start Metro Bundler

```bash
# Using npm
npm start

# OR using Yarn
yarn start
```

#### ๐Ÿค– Android

```bash
# Using npm
npm run android

# OR using Yarn
yarn android
```

#### ๐ŸŽ iOS

```bash
# Using npm
npm run ios

# OR using Yarn
yarn ios
```

## ๐Ÿ› ๏ธ Development

### ๐Ÿ“ Available Scripts

| Command | Description |
| -------------------- | --------------------------------- |
| `npm start` | ๐Ÿš€ Start Metro bundler |
| `npm run android` | ๐Ÿค– Run on Android device/emulator |
| `npm run ios` | ๐ŸŽ Run on iOS device/simulator |
| `npm run lint` | ๐Ÿ” Run ESLint |
| `npm run lint:fix` | ๐Ÿ”ง Fix ESLint issues |
| `npm run format` | โœจ Format code with Prettier |
| `npm run type-check` | ๐Ÿ“‹ Run TypeScript checks |
| `npm run test` | ๐Ÿงช Run tests |

### ๐ŸŽฏ Development Tips

- **Fast Refresh**: Save any file to see changes instantly
- **Debug Menu**:
- **Android**: Ctrl + M (Windows/Linux) or Cmd โŒ˜ + M (macOS)
- **iOS**: Cmd โŒ˜ + D
- **Reload App**:
- **Android**: Press R twice
- **iOS**: Press R in simulator

## ๐Ÿ—๏ธ Project Structure

```
src/
โ”œโ”€โ”€ ๐ŸŽจ assets/ # Images, fonts, stickers
โ”œโ”€โ”€ ๐Ÿงฉ components/ # Reusable UI components
โ”œโ”€โ”€ ๐Ÿ“ฑ screens/ # App screens
โ”œโ”€โ”€ ๐ŸŽ›๏ธ features/ # Feature-specific modules
โ”œโ”€โ”€ ๐Ÿ”ง hooks/ # Custom React hooks
โ”œโ”€โ”€ ๐ŸŒ contexts/ # React contexts
โ”œโ”€โ”€ ๐Ÿ“ฆ types/ # TypeScript type definitions
โ””โ”€โ”€ ๐Ÿ› ๏ธ utils/ # Utility functions
```

---

**๐ŸŽ‰ Happy Meme Making! ๐ŸŽŠ**

Made with โค๏ธ and โ˜•