Document the 90 day pause/restore window for free tier (#27220)

* document 90 pause/restore window

* typo

* another typo

* tier -> plan

* reviewdog tweaks

* edits

* format

* merge pause-and-restore into the section of migrating-and-upgrading

---------

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

apps/docs/content/guides/platform/migrating-and-upgrading-projects.mdx

@@ -63,6 +63,39 @@ Breaking changes are generally only present in major version upgrades of Postgre
 
 If you are upgrading from a significantly older version, you will need to consider the release notes for any intermediary releases as well.
 
+#### Time Limits
+
+Starting from 2024-06-13, when a project is paused, users then have a 90-day window to restore the project on the platform from within Supabase Studio.
+
+The 90-day window allows Supabase to introduce platform changes that may not be backwards compatible with older backups. Unlike active projects, static backups can't be updated to accommodate such changes.
+
+During the 90-day restore window a paused project can be restored to the platform with a single button click from [Studio's dashboard page](https://supabase.com/dashboard/projects).
+
+<div>
+  <Image
+    alt="Project Paused: 90 Days Remaining"
+    src="/docs/img/guides/platform/paused-90-day.png"
+  />
+</div>
+
+After the 90-day restore window, you can download your project's backup file from the project dashboard. This backup is compatible with [pg_restore](https://www.postgresql.org/docs/current/app-pgrestore.html). You can extract your data from it, or attempt to manually restore the project.
+
+<div>
+  <Image
+    alt="Project Paused: 90 Days Remaining"
+    src="/docs/img/guides/platform/paused-dl-backup.png"
+  />
+</div>
+
+If you upgrade to a paid plan while your project is paused, any expired one-click restore options are reenabled. Since the backup was taken outside the backwards compatibility window, it may fail to restore. If you have a problem restoring your backup after upgrading, contact [Support](/support).
+
+<div>
+  <Image
+    alt="Project Paused: 90 Days Remaining"
+    src="/docs/img/guides/platform/paused-paid-tier.png"
+  />
+</div>
+
 #### Disk sizing
 
 When upgrading, the Supabase platform will "right-size" your disk based on the current size of the database. For example, if your database is 100GB in size, and you have a 200GB disk, the upgrade will reduce the disk size to 120GB (1.2x the size of your database).

packages/shared-data/config.ts

@@ -104,6 +104,15 @@ const config = {
       value: 5,
     },
   },
+  pausing: {
+    /**
+     * Inactivity period after which projects may be paused.
+     */
+    free_tier: {
+      value: '1',
+      unit: 'week'
+    }
+  }
 } as const
 
 export default config