diff --git a/README.md b/README.md index eebaaa8c..7663f267 100644 --- a/README.md +++ b/README.md @@ -111,6 +111,7 @@ Before you start make sure you have installed: ### Compatibility #### Node.js + Parse Server is continuously tested with the most recent releases of Node.js to ensure compatibility. We follow the [Node.js Long Term Support plan](https://github.com/nodejs/Release) and only test against versions that are officially supported and have not reached their end-of-life date. | Version | Latest Version | End-of-Life | Compatible | @@ -122,6 +123,7 @@ Parse Server is continuously tested with the most recent releases of Node.js to | Node.js 18 | 18.1.0 | April 2025 | ✅ Yes | #### MongoDB + Parse Server is continuously tested with the most recent releases of MongoDB to ensure compatibility. We follow the [MongoDB support schedule](https://www.mongodb.com/support-policy) and only test against versions that are officially supported and have not reached their end-of-life date. | Version | Latest Version | End-of-Life | Compatible | @@ -134,6 +136,7 @@ Parse Server is continuously tested with the most recent releases of MongoDB to | MongoDB 5.2 | 5.2.1 | TBD | ✅ Yes | #### PostgreSQL + Parse Server is continuously tested with the most recent releases of PostgreSQL and PostGIS to ensure compatibility, using [PostGIS docker images](https://registry.hub.docker.com/r/postgis/postgis/tags?page=1&ordering=last_updated). We follow the [PostgreSQL support schedule](https://www.postgresql.org/support/versioning) and [PostGIS support schedule](https://www.postgis.net/eol_policy/) and only test against versions that are officially supported and have not reached their end-of-life date. Due to the extensive PostgreSQL support duration of 5 years, Parse Server drops support if a version is older than 3.5 years and a newer version has been available for at least 2.5 years. | Version | PostGIS Version | End-of-Life | Parse Server Support End | Compatible | @@ -144,6 +147,7 @@ Parse Server is continuously tested with the most recent releases of PostgreSQL | Postgres 14 | 3.2 | November 2026 | April 2025 | ✅ Yes | ### Locally + ```bash $ npm install -g parse-server mongodb-runner $ mongodb-runner start @@ -236,7 +240,6 @@ $ curl -X GET \ } ] } - ``` To learn more about using saving and querying objects on Parse Server, check out the [Parse documentation](http://docs.parseplatform.org). @@ -386,6 +389,7 @@ const server = ParseServer({ ``` ## Custom Routes + **Caution, this is an experimental feature that may not be appropriate for production.** Custom routes allow to build user flows with webpages, similar to the existing password reset and email verification features. Custom routes are defined with the `pages` option in the Parse Server configuration: @@ -418,6 +422,7 @@ The above route can be invoked by sending a `GET` request to: The `handler` receives the `request` and returns a `custom_page.html` webpage from the `pages.pagesPath` directory as response. The advantage of building a custom route this way is that it automatically makes use of Parse Server's built-in capabilities, such as [page localization](#pages) and [dynamic placeholders](#dynamic-placeholders). ### Reserved Paths + The following paths are already used by Parse Server's built-in features and are therefore not available for custom routes. Custom routes with an identical combination of `path` and `method` are ignored. | Path | HTTP Method | Feature | @@ -513,6 +518,7 @@ Identical requests are identified by their request header `X-Parse-Request-Id`. Deduplication is only done for object creation and update (`POST` and `PUT` requests). Deduplication is not done for object finding and deletion (`GET` and `DELETE` requests), as these operations are already idempotent by definition. ### Configuration example + ``` let api = new ParseServer({ idempotencyOptions: { @@ -521,6 +527,7 @@ let api = new ParseServer({ } } ``` + ### Parameters | Parameter | Optional | Type | Default value | Example values | Environment variable | Description | @@ -553,6 +560,7 @@ Assuming the script above is named, `parse_idempotency_delete_expired_records.sh ## Localization ### Pages + **Caution, this is an experimental feature that may not be appropriate for production.** Custom pages as well as feature pages (e.g. password reset, email verification) can be localized with the `pages` option in the Parse Server configuration: