chore: addition of changelog and manifest upgrade

.gitignore

@@ -27,9 +27,6 @@ lerna-debug.log*
 coverage/
 *.lcov
 
-# Documentation
-docs/
-
 # Operating system files
 .DS_Store
 .DS_Store?

CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.  
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),  
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [v2.0.0] - 2025-11-24
+
+### Added
+
+- **Monorepo structure** with framework-specific samples:
+  - `react/` - Auth0 ACUL React SDK sample
+  - `react-js/` - Auth0 ACUL JS/TS SDK sample
+- Centralized documentation in `/docs/` folder
+- Migration guide for upgrading from v1.x to v2.0.0
+- Per-sample `package.json` and build scripts
+- Standardized setup and configuration across samples
+
+### Changed
+
+- Repository restructured from single-sample to monorepo layout
+- Each sample now has its own dependencies and scripts
+- Updated documentation to reflect new folder structure
+- Improved CI/CD pipeline for multi-sample validation
+
+### Breaking Changes
+
+- **Folder structure**: Sample code moved into framework-specific folders (`/react/`, `/react-js/`)
+- **Scripts**: Each sample has its own `package.json` - run commands from the respective sample directory
+- **Dependencies**: Version bumps and reorganized modules - check each sample's `package.json`
+- **Documentation**: Moved into `/docs/` folder
+
+### Migration
+
+See [Migration Guide](./docs/migration-plan.md) for detailed upgrade instructions from v1.x to v2.0.0.
+
+---
+
+## [v1.0.0] - 2025-10-27
+
+### Added
+
+- Initial release of the Auth0 ACUL sample app
+- Single auth0-acul-js SDK integration example
+- Basic documentation and setup instructions
+
+### Deprecated
+
+- This version is now superseded by **v2.0.0 (monorepo)** release
+- v1.0.0 remains available for legacy projects via `git checkout v1.0.0`
+
+---
+
+## How to Use This Changelog
+
+- **[Unreleased]** - Changes that are in development but not yet released
+- **[vX.Y.Z]** - Released versions with date
+- **Added** - New features
+- **Changed** - Changes in existing functionality
+- **Deprecated** - Soon-to-be removed features
+- **Removed** - Removed features
+- **Fixed** - Bug fixes
+- **Security** - Security fixes

docs/migration-plan.md

@@ -0,0 +1,181 @@
+# Migration Guide — v1.x → v2.0.0 (Monorepo)
+
+## Overview
+
+Starting from **v2.0.0**, this repository has been restructured into a **monorepo**.  
+Each framework-specific sample now lives under its own folder at the repository root.
+
+```
+/react/           → React SDK sample
+/react-js/        → JS/TS SDK sample
+/docs/            → Documentation and migration guides
+```
+
+---
+
+## Why This Change?
+
+- To simplify maintaining multiple samples in one repository
+- To reduce duplication and standardize setup/configuration
+- To enable automated releases and changelogs
+- To support CI/CD pipelines for sample validation
+
+---
+
+## How to Stay on the Old Version
+
+If your existing projects depend on the old structure:
+
+```bash
+git checkout v1.0.0
+```
+
+That version will remain available indefinitely as the last **v1.x (legacy)** release.
+
+---
+
+## Breaking Changes
+
+| Area             | Change                                                 | Notes                                         |
+| ---------------- | ------------------------------------------------------ | --------------------------------------------- |
+| Folder structure | Sample code moved into framework-specific folders      | Adjust your paths and setup steps accordingly |
+| Scripts          | Each sample now has its own `package.json` and scripts | Run commands per sample directory             |
+| Dependencies     | Version bumps and reorganized modules                  | Check each sample's `package.json`            |
+| Documentation    | Moved into `/docs/`                                    | Updated setup and run instructions            |
+
+---
+
+## Migration Steps
+
+### 1. Update Your Local Repository
+
+```bash
+# Fetch the latest changes
+git fetch origin
+
+# Switch to v2.0.0
+git checkout v2.0.0
+# or
+git checkout feat/monorepo-conversion-samples
+```
+
+### 2. Choose Your Sample
+
+Navigate to the appropriate sample directory:
+
+```bash
+# For React SDK sample
+cd react/
+
+# OR for JS/TS SDK sample
+cd react-js/
+```
+
+### 3. Install Dependencies
+
+Each sample has its own dependencies:
+
+```bash
+npm install
+```
+
+### 4. Update Your Scripts
+
+Old v1.x commands:
+
+```bash
+npm run dev
+npm run build
+npm test
+```
+
+New v2.0.0 commands (run from sample directory):
+
+```bash
+# Development
+npm run dev
+
+# Build
+npm run build
+
+# Test
+npm test
+
+# Lint
+npm run lint
+```
+
+### 5. Review Documentation
+
+- Check the sample's local `README.md` for specific setup instructions
+- Refer to `/docs/` for additional guides and documentation
+- Review [CHANGELOG.md](../CHANGELOG.md) for detailed updates
+
+---
+
+## What Changed Per Sample
+
+### React SDK Sample (`/react/`)
+
+- Uses `@auth0/auth0-acul-react` SDK
+- 31 screens implemented
+- Full React 19 + TypeScript + Vite setup
+- Tailwind CSS v4 styling
+
+### JS/TS SDK Sample (`/react-js/`)
+
+- Uses `@auth0/auth0-acul-js` SDK  
+- 3 screens implemented (production-ready)
+- React 19 + TypeScript + Vite
+- Tailwind CSS v4 styling
+
+---
+
+## Common Issues
+
+### Issue: Cannot find module after upgrade
+
+**Solution**: Make sure you're in the correct sample directory and have run `npm install`:
+
+```bash
+cd react/  # or react-js/
+npm install
+```
+
+### Issue: Scripts not found
+
+**Solution**: Each sample has its own scripts. Run commands from the sample directory, not the repository root:
+
+```bash
+cd react/
+npm run dev  # ✅ Correct
+```
+
+Not from root:
+
+```bash
+npm run dev  # ❌ Won't work from root
+```
+
+### Issue: Old imports or paths not working
+
+**Solution**: Update any custom code to reference the new monorepo structure. Check the sample's `package.json` for current dependencies and versions.
+
+---
+
+## Next Steps
+
+- Explore the new monorepo structure (`v2.0.0+`)
+- Read each sample's local `README.md` for setup
+- Refer to the root [CHANGELOG.md](../CHANGELOG.md) for detailed updates
+- Open issues or PRs if you encounter migration problems
+
+---
+
+## Support
+
+For questions or issues:
+
+- Open an issue on [GitHub](https://github.com/auth0-samples/auth0-acul-samples/issues)
+- Check existing documentation in `/docs/`
+- Review sample-specific README files