s:CMS Update & Deployment System

1
s:CMS/
2
├── core/              # ❌ Framework code (receives updates)
3
│   ├── components/    # React & Astro components
4
│   ├── layouts/       # Base layouts
5
│   └── utils/         # Framework utilities
6
│
7
├── usr/               # ✅ Your code (always protected)
8
│   ├── content/       # Your content (MDX, blog posts)
9
│   ├── pages/         # Your pages
10
│   ├── components/    # Your custom components
11
│   ├── layouts/       # Your custom layouts
12
│   ├── public/        # Your static assets
13
│   └── user.config.mjs # Your site configuration
14
│
15
├── scripts/           # Update automation scripts
16
│   ├── setup-upstream.sh
17
│   └── update-core.sh
18
│
19
├── docs/
20
│   ├── UPDATING.md    # Detailed update guide
21
│   └── DEPLOYMENT.md  # Deployment instructions
22
│
23
└── .gitattributes     # Protects usr/ during merges

1
usr/** merge=ours

1
import coreConfig from './core/core.config.mjs'
2
import userConfig from './usr/user.config.mjs'
3
export default merge(coreConfig, userConfig)

1
┌─────────────────────────────────────────┐
2
│ 1. Run: npm run update-core             │
3
└─────────────────────────────────────────┘
4
                    ↓
5
┌─────────────────────────────────────────┐
6
│ 2. Script creates backup branch         │
7
│    backup-before-update-TIMESTAMP       │
8
└─────────────────────────────────────────┘
9
                    ↓
10
┌─────────────────────────────────────────┐
11
│ 3. Fetches latest from upstream         │
12
│    github.com/lad-sapienza/sCMS         │
13
└─────────────────────────────────────────┘
14
                    ↓
15
┌─────────────────────────────────────────┐
16
│ 4. Shows preview of changes             │
17
│    You confirm to proceed               │
18
└─────────────────────────────────────────┘
19
                    ↓
20
┌─────────────────────────────────────────┐
21
│ 5. Merges updates                       │
22
│    • core/ updated                      │
23
│    • usr/ protected                     │
24
│    • configs merged                     │
25
└─────────────────────────────────────────┘
26
                    ↓
27
┌─────────────────────────────────────────┐
28
│ 6. Installs new dependencies            │
29
│    npm install (if package.json changed)│
30
└─────────────────────────────────────────┘
31
                    ↓
32
┌─────────────────────────────────────────┐
33
│ 7. Test: npm run dev                    │
34
│    If OK: delete backup branch          │
35
│    If issues: git reset --hard backup   │
36
└─────────────────────────────────────────┘

1
export const siteMetadata = {
2
  siteUrl: 'https://yourdomain.com',
3
  title: 'Your Site Title',
4
  // ... other settings
5
}

1
export const userConfig = {
2
  integrations: [
3
    // Your custom integrations
4
  ],
5
  // Other Astro config overrides
6
}

1
// Your version + upstream version = merged result
2
{
3
  "dependencies": {
4
    "astro": "^5.1.0",          // Updated version
5
    "my-package": "^1.0.0",     // Your addition
6
    "photoswipe": "^5.4.4"      // New framework dep
7
  }
8
}