Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/vugga/ats-fe

React + typescript + nextjs + redux + apollo-client + react-context + styled-components
https://github.com/vugga/ats-fe

apollo-client graphql nextjs react-context-api reactjs server-side-rendering ssr starter-kit styled-components typescript

Last synced: 2 days ago
JSON representation

React + typescript + nextjs + redux + apollo-client + react-context + styled-components

Awesome Lists containing this project

README

        

[![Netlify Status](https://api.netlify.com/api/v1/badges/18841e65-0949-45b9-a171-b7fb128cb0bd/deploy-status)](https://app.netlify.com/sites/ats-fe/deploys)

# Alien Typer Shit: Frontend

#### User-facing web app. this code produces a simple react js web app with SSR in TS.

![ATS Frontend](https://i.imgur.com/CDZvTZX.png)

### Key ingredients

- **[TypeScript](https://www.typescriptlang.org/)** to ensure the highest code quality
- **[Next.js](https://github.com/zeit/next.js)** to bundle source files and render web pages both on the server and the client (SSR)
- **[React-router-dom](https://www.npmjs.com/package/react-router-dom)** For routing

- **[React Context](https://reactjs.org/docs/context.html)** for static react state
- ~~**[Redux](https://github.com/reduxjs/redux)** for static react state~~
- **[Apollo GraphQL client](https://github.com/apollographql/apollo-client)** to get data from the backend
- **[Styled components](https://www.styled-components.com/)** to produce well-structured and collision-free CSS
- **[ESLint](https://eslint.org/)** and **[Prettier](https://prettier.io/)** to ensure that source files are error-free and easy to read
- **[Docker](https://www.docker.com/)** to make the production version of the microservice straightforward to deploy
- **[GitLab CI](https://about.gitlab.com/features/gitlab-ci-cd/)** to automatically check code quality and generate a new docker image on every push

## Running a local copy

1. Ensure you have the latest git, Node.js and Yarn installed on your machine

```bash
git --version
## ≥ 2.14

node --version
## ≥ 10.0

yarn --version
## ≥ 1.10
```

1. Clone the repo

```bash
cd PATH/TO/MISC/PROJECTS
git clone https://github.com/vugga/ats-fe.git
cd ats-fe
```

1. Install npm dependencies using Yarn

```bash
yarn
```

1. Copy `.env.dist` to `.env`. You can have a look at [`src/config.ts`](src/config.ts) for hints on what is expected.

1) Start the server in development mode

```bash
yarn dev
```

Modifying any of the files will refresh the app, thanks to Next.js hot module reloading.
To stop running the server, press `ctrl+c`.

1) If you want to test a production copy of the microservice, build and run it like this:

```bash
yarn build
yarn start
```