Rocketmeme

A multipurpose meme marketplace and editor for creating and downloading memes. View meme collection, browse different meme categories, like share and save memes.

👀 Preview

Click this link to view rocketmeme

How to run locally ✨

Follow these steps below to run rocketmeme locally in your machine. We are using vite.js to bootstrap this application. You can read their docs for more info.

🧩 Prerequisites

In other to run our react app, make sure you have the following installed locally.

Node.js - vite requires node at least version 10.16.0

Clone this repository

Clone this repository to your local machine.

git clone https://github.com/Evavic44/rocketmeme.git

Cd client

Change directory into the client folder. This is where the frontend code lives.

cd client

Install NPM

npm install

Run

Run the development server to view the app.

npm run dev

Now you can navigate to http://localhost:3000 to view the app.

Adittional Commands ✨

Build

npm run build

This is a preview of your dev server.

Serve

npm run serve

This is a preview of your build

Rocketmeme API

/* API Endpoint */
https://rocketmeme-user.hasura.app/v1/graphql

With Hasura, we were able to create a serverless API using Hasura cloud. The API exists for two types of requests: The meme template and the uploaded memes. If you're interested, you can start exploring the API docs to get an idea of everything possible with the rocketmeme API.💛

API Docs

async function fetchGraphQL(operationsDoc, operationName, variables) {
  const result = await fetch(
    "undefined",
    {
      method: "POST",
      body: JSON.stringify({
        query: operationsDoc,
        variables: variables,
        operationName: operationName
      })
    }
  );

  return await result.json();
}

const operationsDoc = `
  query MyQuery {
    meme_templates(order_by: {id: asc, image_link: asc, title: asc}) {
      id
      image_link
      title
    }
  }
`;

function fetchMyQuery() {
  return fetchGraphQL(
    operationsDoc,
    "MyQuery",
    {}
  );
}

async function startFetchMyQuery() {
  const { errors, data } = await fetchMyQuery();

  if (errors) {
    // handle those errors like a pro
    console.error(errors);
  }

  // do something great with this precious data
  console.log(data);
}

startFetchMyQuery();

🎨 Styling

Styling is done using styled-components and css3

A preview of the style guide.

🤝🏾 Contribution

Are you contributing to this project, please ensure all pull requests and contributions comply with our guidelines. Before making any changes, ensure you have raised an issue here, unless it is a minimal change.

📁 Folder Structure

├── client
│   ├── public
│   │   ├── images
│   │   │   ├── ../
│   │   ├── Robots.txt
│   │   ├── _redirects
│   ├── src
│   │   ├── Components
│   │   │   ├── ../
│   │   ├── pages
│   │   │   ├── ../
│   │   ├── App.jsx
│   │   ├── index.css
│   │   ├── main.jsx
├── src
│   ├── controllers
│   ├── middlewares
│   ├── models
│   ├── routes
│   ├── services
│   ├── utils
│   ├── index.js
├── .env.example
├── .gitignore
├── .gitpod.yml8
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── package.json

This structure is completely flexible and bound to change. Updates to this tree is done manually till we find a suitable generator 😿