Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/elliotjreed/www.joekozak.co.uk

Funny-man Joe Kozak's website
https://github.com/elliotjreed/www.joekozak.co.uk

Last synced: 3 months ago
JSON representation

Funny-man Joe Kozak's website

Awesome Lists containing this project

README

        

[![Build Status](https://travis-ci.org/elliotjreed/www.joekozak.co.uk.svg?branch=master)](https://travis-ci.org/elliotjreed/www.joekozak.co.uk) [![Coverage Status](https://coveralls.io/repos/github/elliotjreed/www.joekozak.co.uk/badge.svg?branch=master)](https://coveralls.io/github/elliotjreed/www.joekozak.co.uk?branch=master)

# JoeKozak.co.uk

The website source code for JoeKozak.co.uk

## PHP API Backend

PHP 7.4 or above and Composer is expected to be installed on our system.

The backend API is located under the `./api` directory.

### Installing Composer

For instructions on how to install Composer visit [getcomposer.org](https://getcomposer.org/download/).

### Installing for Development

After cloning this repository, change into the newly created directory and the subdirectory `api` and run

```
composer install
```

or if you have installed Composer locally

```
php composer.phar install
```

This will install all dependencies needed for the project.

## Running the Tests

All tests can be run by executing

```
vendor/bin/phpunit
```

`phpunit` will automatically find all tests inside the `test` directory and run them based on the configuration in the `phpunit.xml` file.

## Typescript Frontend

### Installing Yarn

For instructions on how to install Yarn visit [yarnpkg.com](https://yarnpkg.com/lang/en/).

### Installing dependencies

The frontend uses Typescript and SASS, and is bundled using Webpack.

To install the required dependencies, change into the `./frontend` subdirectory and run

```
yarn install
```

### Running for development

To run the Webpack development server run:

```
yarn start
```

### Building for production

To build the production-optimised application run:

```
yarn build
```

## Deployment

Deployment is via Docker and Docker Compose.

## Built With

- [PHP](https://secure.php.net/)
- [Composer](https://getcomposer.org/)
- [PHPUnit](https://phpunit.de/)
- [Typescript](https://www.typescriptlang.org/)
- [Yarn](https://yarnpkg.com/lang/en/)
- [Webpack](https://webpack.js.org/)

## License

This project is licensed under the MIT License - see the [LICENCE](LICENCE) file for details.