A scuffed website to display random pictures of random cats of people who contribute to it. No NFTs... yet.
Find a file
2022-01-25 16:00:54 +03:00
images first contact w/ cats 2022-01-24 23:50:49 +03:00
.gitignore ignore files again 2022-01-24 23:52:56 +03:00
docker.sh initial docker script (WIP) 2022-01-24 18:42:51 +03:00
index.js fix inaccurate console logs (ft. my dumbass) 2022-01-24 23:48:52 +03:00
LICENSE we license these 2022-01-25 02:09:14 +03:00
package.json WE LOG THESE 2022-01-24 23:48:21 +03:00
README.md improve styling 2022-01-25 16:00:54 +03:00

🐾 catApi

catApi is scuffed website (fully equipped with an API, obviously) to display pictures of cats from the /images/ directory which are supplied by the kind people who sent me pictures of their cats, and also my own. More cats are always welcome in the paw zone.

I was initially going to name this project "Onlypaws" but I am too lazy to implement a donation system.

Self-Hosting

If you are, for some reason, interested in self-hosting your own version of this website; feel absolutely free to. Fork it, download it, mirror it. Not just that I don't care what you do with the code, I will also appreciate any kind of contributions that you might decide to make. I have been told multiple times that my code is crude and scuffed, so feel free to fix that. Good luck, though.

Dependencies

With Yarn/npm

# Clone this git repository 
git clone https://github.com/NotAShelf/catApi.git

# Move to the new directory
cd catApi

# Install dependencies
yarn 

# Alternatively, to install dependencies
npm install

# Create the .env file for environmental variables (Optional, there are fallback options for both environmental variables)
cp .sample.env .env

# Start the application with
yarn start

# Alternatively, to start the application
npm run start

With Docker Compose

TODO

Versioning

catApi is a new idea I am planning to work on (while the idea, in general, is not new, it is for me in terms of working on a project. Leave me alone.) and thus, we are currently on the V1 branch. V2 will probably introduce proper FrontEnd because let's admit it, a bare website that displays literally a picture and nothing else looks bad. When, you may ask? Whenever the heck I want, I answer.

Contributing

TODO

API Documentation (WIP)

/api/id

return data about the specified image, by ID

  • e.g. http://localhost:3000/api/3

/api/list

return a list of all images on the server (explicitly from the /images directory)

  • e.g. http://localhost:3000/api/list

/api/random

returns data about a random image on the server

  • e.g http://localhost:3000/api/random

License

catApi is licensed under the MIT license.