update README

Author: Florin Mateescu

README.md

@@ -1,68 +1,140 @@
+<<<<<<< HEAD
+
 #
 
-<a alt="Nx logo" href="https://nx.dev" target="_blank" rel="noreferrer"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-logo.png" width="45"></a>
+=======
+
+# Angular 16, Payload CMS, ExpressJs - Free Open-Source Full-Stack Boilerplate
+
+> > > > > > > a3439a7 (update README)
 
+**✨ Professional Web Application Development Starter without the complexity.**
+
+<<<<<<< HEAD
 **[Join Discord Community](https://discord.gg/ERPCG8W6)**
 
 <div style="display: flex; flex-direction: row; justify-content: space-between;">
       <img src="https://binarystarter.com/assets/images/angular/free-architecture-nodejs.png" width="380px" style="width: '100%'; height: auto;"/>
       <img src="https://binarystarter.com/assets/images/angular/free-architecture-angular.png" width="380px" style="width: '100%'; height: auto;"/>
 </div>
+=======
+Secure, Stable, Automated.
+
+**[Join Discord Community](https://discord.gg/ERPCG8W6)**
+
+> > > > > > > a3439a7 (update README)
+
+<div style="display: flex; flex-direction: row; justify-content: space-between;">
+      <img src="https://binarystarter.com/assets/images/angular/free-architecture-nodejs.png" width="380px" style="width: '100%'; height: auto;"/>
+      <img src="https://binarystarter.com/assets/images/angular/free-architecture-angular.png" width="380px" style="width: '100%'; height: auto;"/>
+</div>
+
+# Features
+
+<<<<<<< HEAD
+
+# Installation
+
+# For full documentation refer to https://binarystartercom.notion.site/Documentation-binarystarter-angular-87b451a08050465e83bb47fc124a9029?pvs=4
 
-## Start the app
+- Payload CMS (headless open-source CMS)
+- I18n
+- TailwindCSS
+- Angular Material
+- Lazy Loading
+- Server Side Rendering App
+- Client Side App
+- Authentication, Authorization
+- Lazy loaded Dashboard for authenticated users
+- Standalone Components
+- Pnpm, esbuild
 
-To start the development server run `nx serve express`. Open your browser and navigate to http://localhost:4200/. Happy coding!
+<img src="https://binarystarter.com/assets/images/angular/dashboard-payload.png" width="420px"/>
+>>>>>>> a3439a7 (update README)
 
 # Installation
 
 For full documentation refer to https://binarystartercom.notion.site/Documentation-binarystarter-angular-87b451a08050465e83bb47fc124a9029?pvs=4
 
-If you happen to use Nx plugins, you can leverage code generators that might come with it.
+#### Resources
 
-Run `nx list` to get a list of available plugins and whether they have generators. Then run `nx list <plugin-name>` to see what generators are available.
+- [Intro to nx](https://nx.dev/getting-started/intro)
+- [Install nx](https://nx.dev/getting-started/installation)
+- [Why nx?](https://nx.dev/getting-started/why-nx)
+- [nx: Run Tasks](https://nx.dev/core-features/run-tasks)
+- [nx: Mental Model](https://nx.dev/concepts/mental-model)
+- [pnpm commands](https://github.com/nvm-sh/nvm#usage)
 
-Learn more about [Nx generators on the docs](https://nx.dev/plugin-features/use-code-generators).
+#### Prerequisites:
 
-## Running tasks
+- [Install pnpm](https://pnpm.io/installation)
+- [Install nx cli globally](https://nx.dev/getting-started/installation#installing-nx-globally)
+- Install nodejs v18
 
-To execute tasks with Nx use the following syntax:
+Let’s get started! 🚀
 
-```
-nx <target> <project> <...options>
-```
+#### Clone GitHub Repository
 
-You can also run multiple targets:
+Run in a terminal `git clone https://github.com/binarystarter/binarystarter-angular.git`. To specify another folder name, you can do a direct `git clone https://github.com/binarystarter/binarystarter-angular.git <project_name>`.
 
-```
-nx run-many -t <target1> <target2>
-```
+### Install modules
 
-..or add `-p` to filter specific projects
+Run `pnpm install`.
 
 ### Start the app
 
 Documentation: https://binarystartercom.notion.site/Documentation-binarystarter-angular-87b451a08050465e83bb47fc124a9029?pvs=4
 
-Targets can be defined in the `package.json` or `projects.json`. Learn more [in the docs](https://nx.dev/core-features/run-tasks).
+# The app
+
+### Angular
+
+The angular app can be accessed using http://localhost:4200 - the Server Side Rendered app
+The Angular client-side app can be accessed at HTTP://localhost:4200/app/... and HTTP://localhost:4200/auth/...
+
+### Payload CMS
+
+The payloadcms administration panel can be accessed at HTTP://localhost:8080/admin
+
+### ExpressJS
+
+ExpressJS endpoints can be accessed from HTTP://localhost:8080/...
+
+# Out-of-the-box
+
+## Authentication and Authorization
+
+The authentication system is based on Passport Js.
+
+Out of the box you get the following pages in Angular, connected with the ExpressJs and Payload CMS.
+
+## Angular SSR and Dashboard App
+
+Angular comes with separated modules for the static pages and the single page application.
+
+Separation of concerns is very important at this stage of development of the Angular Universal.
+
+Static Pages are encapsuled in their modules and they don’t interact with browser APIs hungry components.
+
+## DRY - Shared Types between the Backend and Frontend
+
+The Backend TypeScript types should not be available on the Frontend.
 
-## Want better Editor Integration?
+What most developers do is create the same types on both frontend and backend APIs, which makes a bad precedence of duplicated code.
 
-Have a look at the [Nx Console extensions](https://nx.dev/nx-console). It provides autocomplete support, a UI for exploring and running tasks & generators, and more! Available for VSCode, IntelliJ and comes with a LSP for Vim users.
+This problem is solved by using a mono repository.
 
-## Ready to deploy?
+Managed by nx.dev tools - now extending TypeScript types from the Backend or creating them from scratch can be done in a single shared library between your Angular app and ExpressJs Backend.
 
-Just run `nx build demoapp` to build the application. The build artifacts will be stored in the `dist/` directory, ready to be deployed.
+## ExpressJs Server integrated with Payload CMS out of the box
 
-## Set up CI!
+We get all the benefits of a monorepository out of the box.
 
-Nx comes with local caching already built-in (check your `nx.json`). On CI you might want to go a step further.
+ExpressJs is tightly integrated with PayloadCMS, but you can still add your own routes, outside of Payload.
 
-- [Set up remote caching](https://nx.dev/core-features/share-your-cache)
-- [Set up task distribution across multiple machines](https://nx.dev/nx-cloud/features/distribute-task-execution)
-- [Learn more how to setup CI](https://nx.dev/recipes/ci)
+We believe in TypeScript, hence everything is based on TypeScript.
 
-## Connect with us!
+# Connect with me
 
-- [Join the community](https://nx.dev/community)
-- [Subscribe to the Nx Youtube Channel](https://www.youtube.com/@nxdevtools)
-- [Follow us on Twitter](https://twitter.com/nxdevtools)
+- [Twitter](https://twitter.com/florinmtsc)
+- [Website](https://binarycentrum.com/)