chore: add standard-version for automated releases

.github/workflows/ci.yml

@@ -4,7 +4,6 @@ name: CI Pipeline
 on:
   pull_request:
     branches:
-      - dev
       - main
     paths-ignore:
       - '**/*.md'
@@ -103,14 +102,8 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      # Build for dev branch (development config)
-      - name: Build for development
-        if: github.base_ref == 'dev'
-        run: npm run build -- --configuration development
-
-      # Build for main branch (production config)
+      # Always build for production config for PRs to main
       - name: Build for production
-        if: github.base_ref == 'main'
         run: npm run build -- --configuration production
 
       - name: Verify build output

.github/workflows/docker-ci.yml

@@ -4,7 +4,6 @@ name: Docker CI
 on:
   pull_request:
     branches:
-      - dev
       - main
   push:
     branches:

.versionrc.json

@@ -0,0 +1,20 @@
+{
+  "types": [
+    { "type": "feat", "section": "✨ Features" },
+    { "type": "fix", "section": "🐛 Bug Fixes" },
+    { "type": "chore", "section": "🔧 Chores", "hidden": false },
+    { "type": "docs", "section": "📚 Documentation", "hidden": false },
+    { "type": "style", "section": "💎 Styles", "hidden": true },
+    { "type": "refactor", "section": "♻️ Code Refactoring", "hidden": false },
+    { "type": "perf", "section": "⚡ Performance Improvements", "hidden": false },
+    { "type": "test", "section": "✅ Tests", "hidden": false },
+    { "type": "build", "section": "🔨 Build System", "hidden": false },
+    { "type": "ci", "section": "👷 CI/CD", "hidden": false }
+  ],
+  "commitUrlFormat": "https://github.com/victorbruce/angular-starter-project/commit/{{hash}}",
+  "compareUrlFormat": "https://github.com/victorbruce/angular-starter-project/compare/{{previousTag}}...{{currentTag}}",
+  "issueUrlFormat": "https://github.com/victorbruce/angular-starter-project/issues/{{id}}",
+  "userUrlFormat": "https://github.com/{{user}}",
+  "releaseCommitMessageFormat": "chore(release): {{currentTag}}",
+  "issuePrefixes": ["#"]
+}

CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+## [1.0.0](https://github.com/victorbruce/angular-starter-project/releases/tag/v1.0.0) (2024-12-22)
+
+### ✨ Features
+
+- **ci**: implement Docker CI/CD pipeline
+- **ci**: add automated deployment to Render
+- **docker**: dockerize Angular application with multi-stage builds
+- **docker**: add docker-compose for local development
+- **config**: setup branch protection rules
+
+### 📚 Documentation
+
+- add comprehensive README with Docker and CI/CD guides
+- create setup instructions for new developers
+
+### 🔨 Build System
+
+- configure GitHub Actions workflows
+- setup ESLint and Prettier
+- add Husky pre-commit hooks
+
+---
+
+**This is the initial production release with full CI/CD automation.**

README.md

@@ -24,6 +24,7 @@ Live Demo: [View Application](https://angular-starter-project.onrender.com)
 - [🚀 Deployment](#-deployment)
 - [🤝 Team Onboarding](#-team-onboarding)
 - [👤 Author](#-author)
+- [📦 Releases & Versioning](#releases-&-versioning)
 
 ---
 
@@ -547,6 +548,102 @@ MIT License - feel free to use this for personal or commercial projects!
 
 ---
 
+## 📦 Releases & Versioning
+
+This project uses [Semantic Versioning](https://semver.org/) and automated releases with [standard-version](https://github.com/conventional-changelog/standard-version).
+
+### Branching Strategy
+
+**Simple Git Flow:**
+
+```
+main (protected, production releases)
+  ↓
+feature branches (development work)
+```
+
+**Workflow:**
+
+1. Create feature branch from `main`
+2. Develop and commit using [Conventional Commits](https://www.conventionalcommits.org/)
+3. Create PR to `main`
+4. After merge, automated release via standard-version
+
+### Version Format
+
+- **MAJOR** (v2.0.0): Breaking changes
+- **MINOR** (v1.1.0): New features (backward compatible)
+- **PATCH** (v1.0.1): Bug fixes
+
+### Release Process
+
+```bash
+# After merging PR to main
+git checkout main
+git pull origin main
+
+# Automatic version bump based on conventional commits
+npm run release
+
+# Or specify version type explicitly
+npm run release:minor  # New feature
+npm run release:major  # Breaking change
+npm run release:patch  # Bug fix
+
+# Push release with tags
+git push --follow-tags origin main
+```
+
+### Conventional Commits
+
+We use [Conventional Commits](https://www.conventionalcommits.org/) for automatic versioning:
+
+```bash
+feat: new feature        → MINOR version bump (1.0.0 → 1.1.0)
+fix: bug fix             → PATCH version bump (1.0.0 → 1.0.1)
+feat!: breaking change   → MAJOR version bump (1.0.0 → 2.0.0)
+
+# Examples:
+feat: add Angular Material
+fix: resolve Docker build issue
+feat!: upgrade to Angular 21
+
+BREAKING CHANGE: Requires Node.js 22+
+```
+
+### Changelog
+
+All releases are documented in [CHANGELOG.md](CHANGELOG.md) with:
+
+- Version number and date
+- Features, fixes, and changes grouped by type
+- Links to commits and version comparisons
+- Automatically generated from commit messages
+
+### Creating a New Feature
+
+```bash
+# Start from main
+git checkout main
+git pull origin main
+
+# Create feature branch
+git checkout -b feat/my-new-feature
+
+# Make changes and commit
+git add .
+git commit -m "feat: add my new feature"
+
+# Push and create PR
+git push origin feat/my-new-feature
+
+# After PR approved and merged:
+# - Maintainer runs npm run release on main
+# - Version automatically bumped
+# - CHANGELOG automatically updated
+# - Git tag automatically created
+```
+
 ## 🌟 Contributing
 
 For intstructions on contributing, [click here](./CONTRIBUTING.md)