movadee / structurestudios-bikes

Home Page:https://movadee7.github.io/structurestudios-bikes/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Structure Studios Bikes

Bike store management app (Yamaha bikes only)

www.ssbikes.io

Contributing Guidelines · Submit an Issue


Tech stack

Prerequisites

Before you can build and test Angular, you must install and configure the following products on your development machine:

  • Git and/or the GitHub app (for Mac and Windows); GitHub's Guide to Installing Git is a good source of information.
    Windows Users: Git Bash or an equivalent shell is required
    Windows Powershell and cmd shells are not supported #46780 so some commands might fail

  • Node.js, (version specified in the engines field of package.json) which is used to run a development web server, run tests, and generate distributable files.

  • Yarn (version specified in the engines field of package.json) which is used to install dependencies.

  • Angular CLI npm install -g @angular/cli

  • Nx npm install -g nx

Running project locally

Run nx serve bikes-ui for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Running tests locally

Run nx run bikes-ui:test for Jest Unit Tests, nx e2e bikes-ui-e2e for Cypress E2E tests.

Resources

The following resources helps us communicate expectations, manage contributions, and keep track of the project.

  • README.md (this document) describes development setup of the project including documentation, architecture, code standards, setup of testing, automation, github flow, etc.

  • CONTRIBUTING.md describes coding standards and best practices use in this project, sort of developer how-to

  • Architectural Decision Records documents that capture an important architectural decision made along with its context and consequences

  • CHANGELOG.md keeps track of changes in latest releases. We use SemVer for versioning

  • Code Tour (VSCode Extension): to quickly review step-by-step code implementation (see how-to use)

  • Github Projects used for project management and keeping track of bugs

  • Storybook for a quick reference of project reusable components

  • LICENSE.md this project is licensed under MIT License

Software architecture

We think it's important to communicate how we are planning to build a software system or how an existing software system works. If software development team doesn't think about architecture all sort of problems can appear (inconsistent approaches to solving the same problems, deployment problems, maintenance issues, code that hard to scale, etc).

We document our software system architecture using C4 Model approach and Structurizr tool.

Note: architecture diagram goes here

Testing

Describe testing setup. Here is an ADR draft that I've been working on for my personal project so that you can understand better my thought process. fyi, it is incomplete.

Automation

  • Continuous integration (CI) setup
  • Continuous deployment (CD) setup
  • Automatically format and lint code with pre-commit
  • etc.

Monitoring

Describe setup and tools that are used to monitor project health

Contacts

List of project helpful contacts (especially useful for new developers)

About

https://movadee7.github.io/structurestudios-bikes/


Languages

Language:TypeScript 90.1%Language:HTML 8.4%Language:SCSS 1.0%Language:JavaScript 0.5%