repo-template-web-auth-rbac-angular

Generalized authenticated web template with RBAC seams using Angular and TypeScript, with an optional Electron shell.

Status

• Stage: Draft
• Owner:
• License:
• Visibility: Public | Private | Internal
• Reason:
• Promotion criteria to Public:

What This Project Is

• A baseline for authenticated, role-based Angular web apps.
• Includes neutral access-control contracts, API boundary placeholders, and optional desktop wrapper.

Use This Template

1. Click Use this template on GitHub to create a new repository.
2. Rename package/module identifiers and update ownership metadata.
3. Review .env.example and update environment configuration for your target project.
4. Run validation and CI checks before first release.

Quickstart

Prerequisites

• Node.js 20+
• pnpm 10+

Install

pnpm install

Run Web App

pnpm dev

Run Electron Shell (Dev)

ELECTRON_START_URL=http://localhost:4200 pnpm desktop:dev

Checks

pnpm lint
pnpm typecheck

Documentation

• Overview
• Architecture
• ADRs
• Doctrine Snapshot

Validation

bash tools/validate-template.sh core
bash tools/validate-template.sh advisory

Contributing

See CONTRIBUTING.md.