Merge branch 'main' into dependabot/npm_and_yarn/types/node-20.8.8

Makefile

@@ -1,3 +1,14 @@
+#!/usr/bin/make
+
+# --- Load in .env ---
+
+ifneq ("$(wildcard .env)","")
+	include .env
+	export $(shell sed 's/=.*//' .env)
+endif
+
+# --- Some prep ---
+
 ARGS = `arg="$(filter-out $@,$(MAKECMDGOALS))" && echo $${arg:-${1}}`
 DOCKER_RUN_CMD = docker run -it --rm -u $(shell id -u):$(shell id -g) -v ./:/app --workdir="/app" --network="host"
 

README.md

@@ -1,9 +1,73 @@
 
-
-
-serve-api
-
-
+# ISOMERA: The Ultimate Javascript/Typescript SaaS Boilerplate Monorepo for Modern Developers
+
+Unlock the future of seamless SaaS development with ISOMERA, the all-encompassing Javascript/Typescript starter boilerplate monorepo. Designed for visionary developers, ISOMERA streamlines the creation of enterprise-grade applications by providing a robust, modular, and scalable foundation. Whether you're kickstarting a project with React, Next, Nest, or diving deep into TypeORM, Redux, and Material UI, our platform is your ticket to efficiency. Beyond a mere boilerplate, ISOMERA offers comprehensive documentation, training materials, and a community-driven approach. Contribute to the revolution, join a community of like-minded developers, and redefine the standards of SaaS development.
+
+Every developer understands the journey: starting with basic functionalities and, over time, integrating advanced features like 2FA, role management, or intricate middleware logic. At the outset, it might seem manageable, but as your project scales and evolves, these additions can accumulate into months of development time. Not to mention the effort spent ensuring earlier work seamlessly integrates with new features. With ISOMERA, this narrative changes. While not every feature on our ToDo list is immediate, our roadmap is designed with foresight. As your project matures, ISOMERA grows with you, offering advanced functionalities just when you need them. It's not just about the initial boost; it's about the cumulative time and effort saved over the life of your project. Dive straight into innovation, knowing the foundational and advanced are already taken care of.
+
+#### 🌟 Join the ISOMERA Revolution as an Open-Source Contributor! 🌟
+
+Are you passionate about shaping the future of SaaS development? Looking for a platform where your expertise can make a real difference? Welcome to ISOMERA! As an open-source project, we believe in the collective genius of the developer community. Your insights, skills, and dedication can help elevate ISOMERA to new heights. Whether you're a seasoned expert or a newcomer eager to learn, there's a space here for you. Dive into our code, collaborate with like-minded innovators, and let's co-create the ultimate Javascript/Typescript boilerplate for the next generation. Join the ISOMERA family and let's craft the future, one line of code at a time. 🚀
+
+## Preview
+
+* Landing page https://www.isomera.org/
+* Platform https://app.isomera.org/
+* Documentation https://doc.isomera.org/overview.html
+
+## Goals
+
+* To keep this starter project up to date and at best practices.
+* Create training material to make your start easier.
+* Keep UI as simple as possible, so you could choose whether to go with same SCSS, Styled Components, Material UI or Tailwind for your creation
+
+## SDLC ToDo
+
+- [ ] Documentation: Getting Started
+- [ ] Documentation: Going to Production
+- [ ] Training video on how to get started
+- [ ] Training video on best practices
+
+## Technical ToDo
+
+- [x] NX monorepo workspace
+- [x] Landing page with Next.js
+- [ ] CI & Tests
+- [ ] Prettier & Linting
+- [x] Generated documentation for API with Compodoc
+- [ ] Swagger for API endpoints
+- [ ] DTO as shared lib
+- [ ] Redux-toolkit for app data storage
+- [ ] Interfaces as shared lib
+- [ ] Utils as shared lib (for example time formatting)
+- [ ] TypeORM & DB migrations
+- [ ] Plan a strict rules for timestamps (this is frequent problem for projects where users has to interact across multiple timezones)
+- [ ] Connect S3 or other object bucket
+- [ ] Production Dockerfiles
+- [ ] SSL in development
+- [ ] Transactional emails and templates (prod/dev)
+- [ ] Websockets for notifications and updates
+- [ ] GDPR compliance
+- [ ] Easy solution for roles and access management
+- [ ] ...
+
+## Features plan
+
+- [ ] User can Sign Up & Sign In using email
+- [ ] User can Sign Up & Sign In using Google, Facebook, Apple or Microsoft
+- [ ] User can Sign Up & Sign In using phone number (Twillio)
+- [ ] User can reset password
+- [ ] User can invite other team members to organization (org created for every user, if it's not needed, should be easy to disable or just ignore)
+- [ ] User can enter company details to organization (for future billing)
+- [ ] User can manage roles for team (OrgOwner, OrgAdmin, OrgManager, OrgFinance, OrgAnalytic, OrgSupport, OrgUser, OrgReadonly, OrgClientVIP, OrgClient)
+- [ ] User can transfer organization ownership
+- [ ] User can enable 2FA
+- [ ] User can enforce 2FA for organization users
+- [ ] User can edit basic profile details (name, photo)
+- [ ] User can delete organization
+- [ ] User can delete account
+- [ ] ...
+
 ## Developing locally
 
 ### Getting started
@@ -46,12 +110,28 @@ This is pretty simple, just
 make nx run-many -- -t test
 ```
 
+```
+make nx run-many -- -t e2e
+```
+
 ### Running services
 
 #### Run API locally
 
-This will launch API service on port 8080.
+This will launch API service on port 8080:
 
 ```
 make nx serve-api
 ```
+
+This will launch platform on port 4200:
+
+```
+make nx serve-platform
+```
+
+This will launch landing on port 3030:
+
+```
+make nx serve-landing
+```

apps/api/src/main.ts

@@ -9,13 +9,16 @@ import { NestFactory } from '@nestjs/core';
 import { AppModule } from './app/app.module';
 
 //
+
 async function bootstrap() {
   const app = await NestFactory.create(AppModule);
   const globalPrefix = 'api';
   app.setGlobalPrefix(globalPrefix);
   const port = process.env.PORT || 3000;
   await app.listen(port);
-  Logger.log(`🚀 Application is running on: http://localhost:${port}/${globalPrefix}`);
+  Logger.log(
+    `🚀 Application is running on: http://localhost:${port}/${globalPrefix}`
+  );
 }
 
 bootstrap();

apps/landing/app/layout.tsx

@@ -6,6 +6,7 @@ export const metadata = {
 };
 
 //
+
 export default function RootLayout({
   children,
 }: {