Skip to content

szymonkadas/cardboard

Repository files navigation


Logo

Table of Contents
  1. About The Project
  2. Getting Started
  3. Architecture

About

Cardboard is a single page application (SPA) for managing private notes.

Technologies used

Getting Started

Great to see you here!

Below you will find instruction how to setup project locally on your machine.

Prerequisites

  1. Ensure that you have Node.js installed on you machine.
  1. Ensure that you have Yarn installed on you machine.

Installation

  1. Install required project dependencies by typing below command.
    yarn install
  2. Start back-end service by typing:
    yarn server
  3. Start front-end development by typing:
    yarn start

all commands must be typed in terminal in project root directory

Architecture

For architecture flow chart see here.

Directory structure

├── src
│   ├── api
│   │   ├── client.ts // axios client setup
│   │   └── requests.ts // http requests configured
│   ├── components // UI layer
│   │   ├── Board
│   │   │   ├── Board.container.tsx // Container component for keeping business logic inside
│   │   │   ├── Board.tsx // Dumb, presentational component
│   │   │   └── __tests__ // Board integration and unit tests (always try to keep close to implementation)
│   │   └── Icons
│   ├── data // Domain separated data layer
│   │   ├── card
│   │   │   ├── api.ts // Card API requests
│   │   │   ├── dto.ts // Data transfer object (this is how data comes from backend)
│   │   │   ├── factory.ts // Factory for generating models, useful in tests
│   │   │   └── model.ts // Domain types used across front-end app
│   │   └── index.ts
│   ├── hooks // handy, and reusable UI hooks
│   │   ├── useInput.ts
│   │   └── useOutsideClick.ts
│   ├── theme // global styles and tokens
│   │   ├── global.css
│   └── utils // handy functions for solving repeatable problems
│       └── generators.ts

License

All rights to this project belongs to Nerdbord. This project is for educational purposes only.

Contact

Nerdbord, E-mail | Github | LinkedIn

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published