The Unsplash Clone

Upload, Share and Entertain

A clone of the unsplash project powered by react and django web framework.
Explore the site »

Photo gallery · Report Bug · Request Feature

About The Project

This is a web application written in React & Django rest and is automatically deploy on Heroku 🛫

It allows all users Upload new Images which are processed by the django backend and stored on an AWS S3 bucket.

Users can view all free stock photos that have been previously uploaded by other users.

This project can be used as a boiler plate for more ambitious projects

Here's why:

• Your time should be focused on creating something amazing. A project that solves a problem and helps others
• You shouldn't be doing the same tasks over and over like resource configuration.

Built With 💖

Major frameworks and services used in the development of this project.

• React -- A JavaScript library for building user interfaces
• Django -- Python Web framework that encourages rapid development and clean, pragmatic design
• Django REST framework -- Powerful and flexible toolkit for building Web APIs.
• Heroku -- Platform as a service (PaaS) that enables developers to build, run, and operate applications entirely in the cloud.
• AWS S3 -- Reliability & Scalability With AWS Online Storage Solutions for static and media files
• PostgreSQL -- Open-source, highly stable relational database management system emphasizing extensibility and SQL compliance.

Getting Started

To get a local copy up and running follow these simple example steps.

• Clone the repository, which includes both backend and frontend.

  git clone https://github.com/konichar/the-unsplash-clone.git

Django Backend Prerequisites

You need to have the following installed

1. Python https://www.python.org/

2. Install application python dependencies

pip install -r requirements.txt

3. Migrate database

python manage.py migrate

4. Start Django server and Rest API

python manage.py runserver

The backend server should be localhost:8000.

React Frontend Prerequisites

You need to have the following installed

1. Nodejs https://nodejs.org/

2. Install application React dependencies

yarn install

3. Start frontend server

yarn start

The Frontend server should be localhost:3000.

Usage

This project is preconfigured to be deployable on Heroku. Static assets and media files are collected and hosted on AWS S3 when python manage.py collectstatic is run.

For more info about how django manages static files, please refer to the Documentation

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated 😊

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Project Link: https://github.com/konichar/the-unsplash-clone

Demo Link: https://the-unsplash-clone.herokuapp.com/

If you find this project interesting don't forget to leave a star 💥