|
27 | 27 |
|
28 | 28 | - **Own your code** Skip the 3rd Party services — get all of the benefits and security of a hosted AWS application, without going through a middleman. Deploy to a new AWS account, or an existing account and get up and running in five minutes! |
29 | 29 |
|
30 | | -## What’s In This Document |
31 | | - |
32 | | -- [Get Up and Running in 5 Minutes](#-get-up-and-running-in-5-minutes) |
33 | | -- [CLI Reference](#-cli-reference) |
| 30 | +## What's in this Document |
| 31 | + |
| 32 | +- [What's in this Document](#whats-in-this-document) |
| 33 | +- [🚀 Get Up and Running in 5 Minutes](#-get-up-and-running-in-5-minutes) |
| 34 | +- [📖 CLI Reference](#-cli-reference) |
| 35 | + - [`deploy`](#deploy) |
| 36 | + - [Options](#options) |
| 37 | + - [Examples](#examples) |
| 38 | + - [`configure-domain`](#configure-domain) |
| 39 | + - [Options](#options-1) |
| 40 | + - [Examples](#examples-1) |
| 41 | + - [Additional Steps](#additional-steps) |
34 | 42 | - [Continuous Integration](#continuous-integration) |
35 | | -- [Advanced Use Cases](#-advanced-use-cases) |
| 43 | + - [GitHub Actions](#github-actions) |
| 44 | +- [👩🔬 Experimental Features](#-experimental-features) |
| 45 | + - [\_\_experimental_privateS3](#__experimental_privates3) |
| 46 | +- [👩💻 Advanced Use Cases](#-advanced-use-cases) |
| 47 | + - [Serverless UI Advanced Example](#serverless-ui-advanced-example) |
36 | 48 | - [FAQ](#faq) |
37 | 49 | - [License](#license) |
38 | 50 |
|
@@ -180,9 +192,7 @@ A minute or two after running this command, the deploy will "hang" while trying |
180 | 192 |
|
181 | 193 | Since Serverless UI is a command-line tool available via npm, it will work in almost any CI environment. |
182 | 194 |
|
183 | | -### Examples |
184 | | - |
185 | | -#### GitHub Actions |
| 195 | +### GitHub Actions |
186 | 196 |
|
187 | 197 | > Note: Checkout the action in this repo for a live example https://github.com/JakePartusch/serverlessui/actions |
188 | 198 |
|
@@ -231,17 +241,29 @@ jobs: |
231 | 241 | }); |
232 | 242 | ``` |
233 | 243 |
|
234 | | -## 👩🔬 Advanced Use Cases |
| 244 | +## 👩🔬 Experimental Features |
| 245 | + |
| 246 | +In order to use experimental features, a `serverlessui.config.js` file must exist at the base of the project. |
| 247 | + |
| 248 | +### \_\_experimental_privateS3 |
| 249 | + |
| 250 | +This experimental feature allows the configuration of a private S3 bucket — which may be desired for enhanced security. This feature can be enabled in `serverlessui.config.js`: |
| 251 | + |
| 252 | +```javascript |
| 253 | +module.exports = { |
| 254 | + __experimental_privateS3: true, |
| 255 | +}; |
| 256 | +``` |
| 257 | + |
| 258 | +## 👩💻 Advanced Use Cases |
235 | 259 |
|
236 | 260 | For existing serverless projects or those that may have additional CloudFormation and/or CDK infrastructure, Serverless UI provides CDK constructs for each of the cli actions: |
237 | 261 |
|
238 | 262 | ```javascript |
239 | 263 | import { ServerlessUI, DomainCertificate } from '@serverlessui/construct; |
240 | 264 | ``` |
241 | 265 |
|
242 | | -### Examples |
243 | | - |
244 | | -#### Serverless UI |
| 266 | +### Serverless UI Advanced Example |
245 | 267 |
|
246 | 268 | For a full-featured example, check out: |
247 | 269 | https://github.com/JakePartusch/serverlessui-advanced-example |
|
0 commit comments