status-image coverage-image

This project is a mono-repo for FullerStack which is an open source dashboard powered by Angular for the frontend and NestJs for the backend.

To create an open source dashboard from the ground-up. Quality of Experience is the ultimate mission, and that includes simplicity, elegance, quality and performance. Designed for the future, but built for today!

Screenshots: (screenshots)

• Quality of Experience and Security First
• Built-in Auth & Auth (Authentication & Authorization)
  • Powered by JWT (Auth & Access)
  • Fully Stateless
  • Permissions (Roles / Actions)
• Translations
  • Internationalization (i18n)
  • Localization (i10n)
  • Left2Right, Right2Left Support
• GraphQL
  • Frontend & Backend
• PubSub
  • RxJS (Subscription, Push)
  • Fully reactive
• Full SQL Support
  • PostgresQL as the 1st class citizen
• Dark Mode Support
• Fullscreen
• Geo Location Support
  • Geo Fencing
  • IP address filtering (by: proxy count, proxy nodes, public only, best matched)
• ...Etc

npx create-nx-workspace fullerstack

• @fullerstack/agx-store (state management based on KISS principle)
• @fullerstack/nax-ipware (best attempt to grab client's real ip)
• @fullerstack/ngx-cachify (intuitive caching of http calls)
• @fullerstack/ngx-config (injectable angular environment)
• @fullerstack/ngx-gtag (google analytics api for angular)
• @fullerstack/ngx-i18n (i18n support for angular - single compilation)
• @fullerstack/ngx-jwt (jwt utility for angular)
• @fullerstack/ngx-logger (logger for angular)
• @fullerstack/ngx-menu (advanced menu for angular)
• @fullerstack/ngx-store (simple store management for angular - redux)
• @fullerstack/ngx-subify (rxjs subscription management utility for angular)

• Browsers (Angular)
• Desktop (Electron)
• Mobile (NativeScript, Ionic)

• AG = Agnostic (not target specific, node &| browser)
  • AGX = Node/Browser Library
• BA = Browser Framework/Library Agnostic (not framework/library specific, browser-only)
  • BAX = Browser Library
• NA = Node Application Agnostic (not application specific, node-only)
  • NAX = Node Library
• NG = Angular
  • NGX = Angular Library
• NS = Nest
  • NSX = NestJs Library

• WB = Web (Chrome, Firefox, Safari, Edge, etc)
• EL = Electron
• NS = NativeScript (Android // iOS)
• IO = Ionic (Android // iOS)

• appname = Frontend Web (Chrome, Firefox, Safari, Edge, etc)
• appname-el = Frontend Desktop (Electron Application - Linux, MacOS, Windows)
• appname-ns = Frontend NativeScript (Android, iOS)
• appname-ic = Frontend Ionic (Android, iOS)
• appname-api = Backend for app

• appname-e2e = Frontend E2E Web (Chrome, Firefox, Safari, Edge, etc)
• appname-el-e2e = Frontend E2E Desktop (Electron Application - Linux, MacOS, Windows)
• appname-ns-e2e = Frontend E2E NativeScript (Android, iOS)
• appname-ic-e2e = Frontend E2E Ionic (Android, iOS)
• appname-api-e2e = Backend E2E for nest

• Use email for any security related issues
• Use github issues for everything else
• Respect the code of conduct which is: be respectful of others

# Clone the repo
git clone https://github.com/neekware/fullerstack.git
# Install the dependencies
cd fullerstack
yarn install
# Create a database (postgres) for the angular app
createdb avidtrader
# Copy environment variables and update
cp env.example .env
# Migrate the database
yarn prisma:avidtrader-api:migrate:dev
# Seed your database
yarn prisma:avidtrader-api:seed
# Start the backend (in terminal #1)
yarn start:avidtrader-api
# Start the frontend (in terminal #2)
yarn start:avidtrader
# Visit frontend (on mac use open, on windows, just type it in)
open http://localhost:4200
# Signup / Login and take the site for a spin
# Note superuser account is set in your .env (refer to AUTH_SUPERUSER_EMAIL, AUTH_SUPERUSER_PASSWORD)

# Webpack analyzer
yarn nx build avidtrader --stats-json --prod && yarn stats
# Format changed files
yarn format:all
# Lint CI
yarn lint:ci
# Test CI
yarn test:ci
# Test build
yarn build:ci

# Graph dependencies on a branch
# More: https://nx.dev/latest/angular/cli/affected-dep-graph
yarn affected:dep-graph --base=<branch-name> --head=HEAD

• Released under a (MIT) license.

X.Y.Z Version

`MAJOR` version -- making incompatible API changes
`MINOR` version -- adding functionality in a backwards-compatible manner
`PATCH` version -- making backwards-compatible bug fixes

 Language Files Lines Blank Comment Code
--------------------------------------------------------------------------------
 TypeScript 419 22151 2450 4023 15678
 JSON 175 12083 0 0 12083
 Markdown 105 2988 761 0 2227
 HTML 33 1461 110 5 1346
 Sass 54 1341 141 33 1167
 CSS 1 96 7 0 89
 Plain Text 5 94 10 0 84
 JavaScript 3 119 5 38 76
 SQL 2 88 17 16 55
 Toml 1 3 0 2 1
--------------------------------------------------------------------------------
 Total 798 40424 3501 4117 32806
--------------------------------------------------------------------------------

[ Neekware Inc. ] [ Nx ]