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

https://github.com/exposedcat/insta-formatter

Image formatter for Instagram [API]
https://github.com/exposedcat/insta-formatter

Last synced: 3 months ago
JSON representation

Image formatter for Instagram [API]

Awesome Lists containing this project

README

          


Instagram Posts Formatter

![](https://img.shields.io/badge/Telegram-Developer-informational?style=for-the-badge&logo=telegram&logoColor=26A5E4&color=26A5E4)


![](https://img.shields.io/badge/Reddit-Developer-informational?style=for-the-badge&logo=reddit&logoColor=FF5700&color=FF5700)


![](https://img.shields.io/badge/Swagger-Docs-green?style=for-the-badge&logo=swagger)

App preview


โญ๏ธ Features




  • Portrait, Landscape and Standard posts support

  • Using image dominant color as the background for the gaps

  • Convenient for frontend usage

  • Strict code formatting rules

  • Scalable file architecture

  • 100% of API is documented

  • Well-readable git repository with a beautiful README :ะท


๐Ÿ’ผ TODO




  • Write API documentation

  • Add option to specify custom aspect ratio

  • Delete images after formatting


โš™๏ธ Stack




  • Programming language: Node.JS

  • API: Express.JS

  • Running tools: Docker

  • Documentation: Swagger


๐Ÿ”Œ Running



via pure Node.JS


1. Clone this repo:

```bash
git clone https://github.com/ExposedCat/insta-formatter.git
```

2. Go to the project root:

```bash
cd insta-formatter
```

3. Create copy of `.env-example` called `.env` and replace example data with yours
4. Start app (specify name of the config created before):

```bash
CONFIG='.env' npm start
```


via Docker/Podman


0. Install [Docker](https://docs.docker.com/get-docker/) or [Podman](https://podman.io/getting-started/installation)
1. Clone this repo:

```bash
git clone https://github.com/ExposedCat/insta-formatter.git
```

2. Go to project root:

```bash
cd insta-formatter
```

3. Create copy of `.env-example` called `.env` and replace example data with yours
4. Build app image:

```bash
docker build -t insta-formatter-api .
```
or
```bash
podman build -t insta-formatter-api .
```

5. Start app:

```bash
docker-copmpose up -d
```
or
```bash
podman-copmpose up -d
```

**Done**.


via Nodemon


for development


0. Install and run MongoDB server
1. Clone this repo:

```bash
git clone https://github.com/ExposedCat/insta-formatter.git
```

2. Go to project root:

```bash
cd insta-formatter
```

3. Create copy of `.env-example` and replace example data with yours
4. Install dependencies:

```bash
npm install
```

5. Start app (specify name of the config created before):

```bash
CONFIG='.env' npm run dev
```

**Done**.


๐Ÿ”ฉ Dependencies



Production



  • Express.JS

  • DotEnv

  • Helmet

  • UUID


Development



  • Nodemon

  • Prettier