saas786 / sneat-apps

github.com/sneat-co/sneat-apps

A suit of open source apps that help in work & personal life.

Apps for work

• Sneat.team - provides authentication & org structure for below apps:
  • DataTug - SQL & HTTP queries workbench
  • ScrumSpace - daily scrums & retrospectives for agile teams
  • IssueNumber.One - facilitates continuous focused feedback & improvements

Apps for family & personal life

• to be listed here

Tech stack

• TypeScript - typed JavaScript at Any Scale
• Angular - the modern web developer's platform
• Ionic Framework - an open source mobile UI toolkit for building high quality, cross-platform native and web app experiences.
• Capacitor - a cross-platform native runtime for web apps.
• nx by Nrwl - extensible dev tools for monorepos

How to run

Preferable way is not to use global nx but to use:

pnpm run nx serve <APP_NAME>

Shorter way:

pnpx nx serve <APP_NAME>

To make it even shorter first create a shortcut:

alias pnx="pnpm run nx --"

Then run as:

pnx serve <APP_NAME>

Run with source maps

For some reason the serve is running with enabled optimization and no source maps. It results in troubles with debugging.

Here is how to run dev server properly for datatug app:

pnx serve datatug --optimization=false --sourceMap=true

Code generation

To generate new apps & libraries use nx command.

To generate new Angular library

Run next command:

pnx g lib my-lib --buildable --publishable

To generate new Ionic app

Run next command:

nx generate @nxtend/ionic-angular:app my-app

More on how to use NX with Ionic here: https://ionicframework.com/blog/ionic-angular-monorepos-with-nx/

Troubleshooting

Performance: Bundles size

To see chunks content:

1. Build with source maps
2. Run source-map-explorer dist/apps/datatug/main.js

Known issues

Dependencies

Firebase stuck @ v. 8.6.1

There is a known issue with Firebase >= 8.6.2 regards authentication and Firestore rules