Planner V2

The second iteration of Planner4You.

TBA

Both the frontend and backend are programmed in Typescript which is executed by the ts-node package; Typescript is a type safe, and more structured superset of the Javascript lanugage (ES6/ES12-ES2021). We use Yarn on the frontend and backend also, to install packages (like ts-node) and run a local development server.

A GraphQL server is used in the backend, to provide structured and secure interface to interact with the database. TypeORM is the database adapter which connects to the database allowing us to manipulated the tables and data within it; graphql uses the TypeORM adapter in order to access the data. We've not currently chosen a server to serve the backend code to the client, therefore, the project only works locally from development enviroments.

Our database is implemented in Postgres, which is a relational database that uses SQL.

ts-node is a typescript execution engine that allows us to write this project as typescript instead of javascript. ts-node is essentially a `source-to-source compiler` / `transpiler`, as it turns one language into another, i.e. typescript into javascript.

We use Apollo GraphQL as our implementation of GraphQL. (Tutorial here)

cross-env is used for setting the environment mode the project is run in, in a OS independant way. It is used in the package.json file.

blipp is a simple hapi plugin to display the routes table to console at startup.

We're Using a postgress database

TBA

TBA

Using the scripts in the package.json file in the backend directory, use Yarn to run the 'dev' script, e.g.

yarn run dev

which is the same as running:

yarn run cross-env NODE_ENV=development ts-node-dev --files -- ./src/index.ts

• 'Yarn' is our package manager, but also its acting as our server as this is a command for local development
• 'run' tells yarn to execute something
• 'cross-env' is a package used to set the programmign enviroment variables in a OS independant way
• 'NODE_ENV=development' is a cross-env option to set the enviroment to development
• 'ts-node-dev' is our typescript execution engine as we want our typescript files to be executed with a typescript engine
• '- -files' is a ts-node option, to tell ts-node to load files specified in the `tsconfig.json` file. We do this as the `blipp` package doesn't import correctly unless this happens, as ts-node can't see the blipp file in `backend/type/blipp.d.ts`
• '- -' is used to stop options being passed to ts-node (i.e. we passed ts-node '- -files', we don't want to pass anything else)
• './src/index.ts' is the first file we are running as it's the root

…