Skip to content

maximedegreve/TinyFaces

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
January 9, 2023 21:12
July 25, 2021 09:43
January 9, 2023 21:12
January 9, 2023 22:23
January 9, 2023 22:23
July 25, 2021 09:43
January 10, 2023 10:01
December 30, 2016 10:29

TinyFaces πŸ‘¦πŸΌπŸ‘¨πŸΎπŸ‘©πŸ»

Tiny Faces is a free crowd-sourced avatar gallery to use in your personal or commercial projects

Also check out our Figma Plugin and Sketch Plugin

🦾 API

Endpoints

Query

  • quality : Filters the result(s) to lower or higher quality images by using a value from 0 to 10.
  • gender : Possible values for gender can be found in Gender.swift
  • limit : To limit how many results you get back by using a value of 50 or lower. Only works with the data endpoint. When mixed with gender this could return less than n results.

Limitations

  • Max requests per hour per IP address: 60
  • When you've reached your limit you'll receive an error response with status code 493

πŸŽ’ Before building (dependencies)

  • Install Xcode
  • Install Vapor Toolbox
  • Install Docker Desktop
  • Run docker-compose up db
  • Run Package.swift using Xcode
  • Change your Xcode working directory to your root folder: Schemes > TinyFaces > Edit Scheme > Run > Options > Working Directory > [x]
  • Add a .env file to the local root directory this should have the values below:
THUMBOR_URL=URL
THUMBOR_KEY=ABCDEFG

Sadly we can't share our Thumbor setup and therefore you need to run a instance yourself for this to work.

🚧 Building

  • Run the Run target in Xcode
  • The first time this can take a long time because it will seed the database with random first names and last names.
  • The application should now be running on http://localhost:8080

πŸ’Ÿ Heroku:

  1. In the project directory: heroku create --buildpack vapor/vapor
  2. Deploy using git push heroku master or setup continues deployment in Heroku.
  3. For logs use command heroku logs
  4. Make sure you fill in all Config Vars on Heroku, see the snippet below:
URL = https://tinyfac.es
MYSQL_URL =
PORT =
THUMBOR_URL=URL
THUMBOR_KEY=ABCDEFG
SWIFT_BUILD_CONFIGURATION = release

πŸ“– Documentation

Visit the Vapor web framework's documentation for instructions on how to use this package.

About

Free stock avatars for everyone πŸ‘¦πŸΌπŸ‘¨πŸΎπŸ‘©πŸ» (Built w/ Swift)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •