Skip to content

Commit d14b890

Browse files
committed
fix:\fixed changes in reaadme and code
1 parent 82aeda3 commit d14b890

File tree

8 files changed

+95
-131
lines changed

8 files changed

+95
-131
lines changed

README.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
1-
#### ANGULAR BOILERPLATE
2-
[![Version](https://img.shields.io/badge/@angular/core-v14-brightgreen)](http://commitizen.github.io/cz-cli/)
1+
# ARC ANGULAR BOILERPLATE
2+
[![Version](https://img.shields.io/badge/@angular/core-v14-brightgreen)
33

44
<!-- DOCUMENTATION -->
55

6-
# Description
6+
## Description
77

88
- The boilerplate using multiple projects in one Angular environment so that the boilerplate help users
99
to improve code reusability, scalability, maintainability, and customization. It can also help in increase productivity, reduce risks, and improve the quality of application.
@@ -13,7 +13,7 @@
1313

1414
Following are the steps to get started with it:
1515

16-
# Usage
16+
## Usage
1717

1818
#### Step 1:Clone the boilerplate project repository to your local machine
1919

@@ -40,7 +40,6 @@ BOILER-PLATE
4040
├── .gitignore
4141
├── commitlint.config.js
4242
├── CODE_OF_CONDUCT.md
43-
├── lerna.json
4443
├── package-lock.json
4544
├── package.json
4645
├── README.md
@@ -49,12 +48,13 @@ BOILER-PLATE
4948
As can be seen above, scaffold has initialized and set up a lot, such as:
5049

5150
1. GitHub PR template inside `.github`
52-
2. Conventional commits enablement using commitizen (`.cz-config.js`), commitlint (`commitlint-config.js`) and husky for githooks.
53-
3. `.gitignore` for ignoring files from source code. Important for secure coding and keeping the repo clean on SCM (git)
54-
4. `lerna.json` which contains the setup for lerna commands. Lerna is going to be our monorepo manager and build tool going forward. It is one of the most popular monorepo managers in the industry, used by Jest, NestJS, LoopBack, and Nx.
55-
5. `package.json` and `package-lock.json` for npm to work.
56-
6. The folder named `projects`:
57-
- Projects will hold the multi application pattern and will always be completely independent
51+
2. Conventional commits enablement using commitizen (`.cz-config.js`), commitlint (`commitlint-config.js`)
52+
and husky for githooks.
53+
3. `.gitignore` for ignoring files from source code. Important for secure coding and keeping the repo clean
54+
on SCM (git)
55+
4. `package.json` and `package-lock.json` for npm to work.
56+
5. The folder named `projects`: Projects will hold the multi application pattern and will always be
57+
completely independent
5858

5959
#### The Structure is main project folder
6060

@@ -71,7 +71,7 @@ PROJECTS
7171
├── (...other files)
7272
```
7373

74-
# Projects
74+
## Projects
7575
1. Arc:
7676
- This boilerplate arc project is a project set up that can be easily altered to create new projects.
7777
The user is able to use in the original project, its foundation, and its structure to set up a new one without changing the original.
@@ -82,23 +82,23 @@ PROJECTS
8282
For further reference you can refer [Here](Projects/arc-lib/README.md)
8383

8484

85-
### Step 3: Start the Server
85+
#### Step 3: Start the Server
8686

8787
```sh
8888
ng serve
8989
```
9090

9191
You'll see a message saying Server is running at `http://localhost:4200/` Navigate to this URL. The application will automatically reload if you change any of the source files.
9292

93-
### Build the Application
93+
## Build the Application
9494

9595
To build the project. The build artifacts will be stored in the `dist/` directory.
9696

9797
```sh
9898
ng build
9999
```
100100

101-
### Running unit tests
101+
## Running unit tests
102102

103103
Run `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).
104104

lerna.json

Lines changed: 0 additions & 33 deletions
This file was deleted.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"name": "main-project",
2+
"name": "@arc/boiler-plate",
33
"version": "0.0.0",
44
"scripts": {
55
"ng": "ng",

projects/arc-lib/README.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
#### ARC-LIBRARY
1+
# ARC-LIBRARY
22

3-
# Description
3+
## Description
44

55
- In an Angular multiproject workspace, a shared library is a package that contains reusable code and
66
functionality that can be used across multiple projects within the workspace.
@@ -27,9 +27,9 @@ The Structure of the arc-lib is as follows
2727
- Angular arc library provides various features and components to help developers get started with
2828
their projects quickly. Here are some of the features and components that provides:
2929

30-
# Core Module:
30+
## Core Module:
3131

32-
## API:
32+
### API:
3333

3434
- Adapters: We are using 3 adapters named `anyAdapter` , `countAdapter` and `nameAdapter`. We
3535
use these adapters for manipulating the data, as we get the data from the api.
@@ -40,7 +40,7 @@ The Structure of the arc-lib is as follows
4040
- Models: We are using 3 models named `count.model`,`named-id-required.model` and
4141
`named-id. model`. In these models The boilerplate usingmodel based validations.
4242

43-
## Auth:
43+
### Auth:
4444

4545
- Adaptors: Two adapter service provided are `logged-in-user-adapter.service` and
4646
`login-adapter. service` which helps in adapting API response to a LoggedInUserDM model representing a logged-in user or adapting the LoginModel object to the API request format and adapting the API response which allows for a separation of concerns between the API response data and the application data model.
@@ -56,7 +56,7 @@ The Structure of the arc-lib is as follows
5656
in to a system and the the response from server after a user gets authenticated
5757
and obtains a new access token and refresh token.
5858

59-
## Decorator:
59+
### Decorator:
6060

6161
We are using 2 decorators named `required.decorator` and `validate.decorator`.
6262

@@ -66,12 +66,12 @@ We are using 2 decorators named `required.decorator` and `validate.decorator`.
6666
a parameterized constructor. The required decorator adds metadata to the target constructor and validate uses `Reflect.getMetadata` to retrieve the required properties and validate them in the constructor.
6767
These decorators help to ensure that required properties are not left undefined or null.
6868

69-
## Interceptors:
69+
### Interceptors:
7070

7171
The boilerplate using 3 Interceptors named `auth.interceptor`,`error.interceptor` and `session-recovery.interceptor`. These interceptors are responsible for adding an authorization header to requests that require authentication, checks for errors that occur during HTTP requests and
7272
displays error messages and also refreshes the user's authentication token when the session gets expired.
7373

74-
## Localization:
74+
### Localization:
7575

7676
The boilerplate using i18n module as a language translator where The boilerplate using 3 files as follows :
7777

@@ -82,15 +82,15 @@ The boilerplate using i18n module as a language translator where The boilerplate
8282
- Service: The translationService provides localization functionality to the application. It
8383
depends on `@ngx-translate/core` library to handle translations allowing users to select their preferred language for the application & to provide appropriate translations based on that preference.
8484

85-
## Env Resolver Service:
85+
### Env Resolver Service:
8686

8787
The purpose of this service (implements the Resolve interface and is responsible for resolving the environment configuration ) is to retrieve environment configuration data from a store (`SystemStoreFacadeService`) and make it available to components before they are displayed.
8888

89-
## Store:
89+
### Store:
9090

9191
Store module provides `store-keys.enum`,`user-session-store.service` and`system-store-facade.service`. These are used to fetch and update environment configurations.It also updates the environment configurations in memory and logs the change in the logging system.Also, provides methods to save, retrieve, and remove user session data such as access token, refresh token, user information, and last accessed URL.
9292

93-
## Toaster:
93+
### Toaster:
9494

9595
- In this The boilerplate using toaster named `Itoaster` this is a user interface component that displays
9696
notifications or alerts to users in a non-intrusive way. Itoaster notifications typically appear as small pop-up messages that provide feedback or information.
@@ -108,31 +108,30 @@ Also, provides methods to register icon packs with the NbIconLibraries service.
108108
For more details about Theme Module,refer [Here](/projects/arc-lib/src/lib/theme/readme.md)
109109
(./src/lib/theme/readme.md)
110110

111-
# Components:
111+
## Components:
112112

113-
## Select Component
113+
### Select Component
114114

115115
This component supports auto-completion, filtering of options by search terms, and the
116116
ability to add new tags that are not present in the list of options. There are also several configurable options, such as the ability to select multiple items, the placeholder text for the input field, and the width and height of the dropdown panel and provides a reusable component for displaying a searchable list of items with a selectable checkbox and dropdown with customized states.
117117

118-
## Gantt Component:
118+
### Gantt Component:
119119

120120
In this The boilerplate usingbb.gantt,bb.gantt charts,bb.gantt bars a Gantt chart is a user interface component that displays project tasks or events over a timeline, allowing users to visualize the schedule and progress of a project.
121121

122-
## Login Component:
122+
### Login Component:
123123

124124
- Login component allows users to authenticate themselves by entering their credentials, such as a username
125125
and password and also we can login with google.
126126
- The component is a basically for an Angular login page with a Google login option
127127
- The login component may also include features such as password reset, remember me functionality, and
128128
social login options.
129129

130-
## Auth Component:
130+
### Auth Component:
131131

132132
- Auth component is a module that handles the authentication and authorization of users. It is responsible
133133
for managing user sessions, verifying user credentials, and granting access to protected resources based on the user's role and permissions.
134134
- The auth component typically includes a login as well as a registration form for new users to create
135135
an account. The component may also handle password reset functionality and provide options for users to manage their accounts
136136

137-
For more details about Components ,refer [Here](/projects/arc-lib/src/lib/components/readme.md)
138-
137+
For more details about Components ,refer [Here](/projects/arc-lib/src/lib/components/readme.md)

projects/arc-lib/src/lib/components/readme.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
1-
#### COMPONENTS
1+
# COMPONENTS
22

3-
1. Gantt
3+
## Gantt
44

5-
# GanttBarComponent
5+
### GanttBarComponent
66

77
- The component is used to render the bars for the Gantt chart. It is generic and can be used with any type
88
of task value. The component contains properties and methods for rendering the bars and sub-allocations, formatting the allocation values, and translating labels using the `TranslationService` and `TranslateService`.
99

10-
# GanttColumnComponent
10+
### GanttColumnComponent
1111

1212
- This Component is used to displays a single column of the Gantt chart. It has several input properties
1313
like
@@ -21,39 +21,39 @@
2121
- `contextItemFilter`: A function that takes a GanttTaskValue object as input and returns a boolean
2222
indicating whether to display the context menu items for that task or not.
2323

24-
# GanttHeaderComponent
24+
### GanttHeaderComponent
2525

2626
- The component that represents the header of a Gantt chart. It has several inputs, including
2727
`searchPlaceholder` string representing the placeholder text to be displayed in the search box and `showSearch` A boolean value indicating whether the search box should be displayed or not.
2828

29-
# GanttChartTooltipComponent
29+
### GanttChartTooltipComponent
3030

3131
- The component which is displayed when hovering over a Gantt chart bar.The tooltip displays information
3232
about a SubAllocation object, including its start and end dates, allocation rate, and allocated hours per day. The SubAllocation object is passed to the component using the item input property.The component has methods for formatting the allocation rate and allocated hours per day values into readable strings
3333

34-
# Service:
34+
## Service:
3535

36-
1. GanttService
36+
### GanttService
3737

3838
- The GanttService class has several private properties, including ` _data`, `_overlays`, `_tooltipOverlay`,
3939
`_eventHandlers` etc
4040
- The render method takes an ElementRef representing the container containing options to configure the Gantt
4141
chart. The method sets several properties such as the `row_height, bar_height, scale_height`, and readonly properties. It also sets up the layout of the Gantt chart and registers event handlers for task clicks and
4242
grid header clicks.
4343

44-
2. Timeline-scale
44+
### Timeline-scale
4545

4646
- `MonthlyScaleService` : This is an service for generating a monthly scale for a Gantt chart It provides a configuration for displaying the Monthly timeline scale for a Gantt chart. The `config()` method, which returns an array of objects representing the different units in the timeline scale.The `GanttScaleService` interface defines a contract for a service that can be used to generate scale configurations for different timelines. The `MonthlyScaleService` class implements this interface by defining the scale property, which is set to Timelines.Monthly
4747

4848
- `QuarterlyScaleService` : This is an service for generating a quarterly scale for a Gantt chart. The service implements the `GanttScaleService` interface and provides a `config()` method that returns an array of scale configuration objects.The `QuarterlyScaleService` class has a scale property that is set to Timelines.Quarterly, indicating that this service generates a quarterly scale.
4949

5050
- `WeeklyScaleService` : This defines service called `WeeklyScaleService` which implements the `GanttScaleService` interface. The `GanttScaleService` interface defines the contract that all Gantt scale services must adhere to. The `WeeklyScaleService` service provides a configuration for a Gantt chart with a weekly timeline. The configuration includes an array of objects that specify the scale units, step size, and formatting for each unit.The `config()` method returns an array of two objects. The first object represents the weekly scale unit and formats the date using the `_formatWeeklyScale` private method. The second object represents the daily scale unit and formats the date using the `toLocaleString()`
5151

52-
# GanttModule
52+
### GanttModule
5353

5454
- This is an Angular module called GanttModule which declares and exports a components and Modules related to Gantt.The module also provides three different `GanttScaleService` implementations as providers using the GANTT_SCALES injection token: `MonthlyScaleService`, `WeeklyScaleService`, and `QuarterlyScaleService`as we discuss above
5555

56-
2. Resize
56+
## Resize
5757

5858
- The ResizeService provides reactive programming features in the application.
5959
- `filter` allows filtering values emitted by an Observable based on a predicate function.
@@ -64,9 +64,7 @@
6464
- we can say the ResizeService provides a convenient way to listen for and observe changes in the size of an
6565
element in an Angular application.
6666

67-
3. Select
68-
69-
# ListComponent:
67+
## ListComponent:
7068

7169
- This component implements the behavior of a search and select component. It has several methods,
7270
the methods are creating a Set of removed items, assigning a copy of the options to the visibleList array, sorting the list by groups, and subscribing to changes in the value of a search control.
@@ -75,7 +73,9 @@
7573
- It also retrieves the name of an item by getting the value of the name field of the item,removes an item
7674
from the list and emits an event,method checks if an item is a placeholder item,selects the first item in the list if the user presses enter on the search box and there are items in the list and groups the visibleList array according to the groupConfig property.
7775

78-
# SelectComponent
76+
## Selector
77+
78+
### SelectComponent
7979

8080
- The component is used to display a list of options that can be selected by the user. The selected options
8181
can be displayed as tags. The component has various inputs and outputs
@@ -86,24 +86,24 @@
8686
- The component emits several events, including added, removed, and cleared for changes to the selection
8787
(s), and `newAdded` and `newRemoved` for changes to custom values entered by the user.It also provides a valueChange output for two-way binding of the selected value(s).
8888

89-
# TestComponent
89+
### TestComponent
9090

9191
- This component defines the behavior of a select dropdown in the UI.The options property is an array of
9292
`NameIdRequired` objects that will be displayed as the available options in the dropdown.
9393
- The multiple, allowInput, disabled, and search properties are boolean values that control various aspects
9494
of the dropdown behavior. `multiple` specifies whether multiple options can be selected at once, `allowInput` specifies whether the user can input a custom option, `disabled` specifies whether the dropdown is disabled or not, and `search` specifies whether a search box is displayed to filter the options.
9595

96-
4. Auth
96+
## Auth
9797

98-
# Login Component:
98+
### Login Component:
9999

100100
- Login component allows users to authenticate themselves by entering their credentials, such as a username and password and also we can login with google.
101101
- The login component typically includes a form with input fields for the user's credentials, as well as a submit button to initiate the login process also gives us option to login via google.
102102
- The login component communicates with a backend server to verify the user's credentials and grant access to the application if the user is authorized. Upon successful authentication, the login component typically stores the user's session information, such as a token or cookie, to allow the user to access protected resources without having to login again.
103103
- The component is a basically for an Angular login page with a Google login option
104104
- The login component may also include features such as password reset, remember me functionality, and social login options.
105105

106-
# Auth Component:
106+
### Auth Component:
107107

108108
- Auth component is a module that handles the authentication and authorization of users. It is responsible
109109
for managing user sessions, verifying user credentials, and granting access to protected resources based on the user's role and permissions.
@@ -115,7 +115,7 @@
115115
the `@nebular/auth` package. This component is responsible for handling the authentication process in the Angular application. It is using dependency injection to inject the `NbAuthService` and `Location` dependencies into the component's constructor.
116116

117117

118-
# Animations
118+
### Animations
119119

120120
- These animations could be used to provide visual feedback when elements are added or removed fro DOM,
121121
or to animate UI elements such as buttons or icons.and it also defines two Angular animations, dropdownAnimation and rotateAnimation.

0 commit comments

Comments
 (0)