tiktok-sparo/apps/website
Pete Gonzalez 12ddfb4710
Merge pull request #49 from tiktok/octogonz/website-fixes2
Publish sparo-profile.schema.json on the website
2024-03-04 22:35:32 -08:00
..
config chore: config dist folders for build phase 2024-03-01 23:32:43 -08:00
docs Merge pull request #49 from tiktok/octogonz/website-fixes2 2024-03-04 22:35:32 -08:00
src Improve website logo appearance in dark mode 2024-02-26 22:33:20 -08:00
static Improve the JSON schema docs 2024-03-04 22:28:05 -08:00
babel.config.js npx create-docusaurus@latest website classic 2024-02-21 22:17:23 -08:00
build.js Fix an issue where the website project did not get built by CI 2024-02-23 15:34:27 -08:00
docusaurus.config.js Enable trailingSlash=true for GitHub Pages 2024-03-04 22:09:36 -08:00
package.json Finally fix the problem where ```shell was not highlighted correctly 2024-03-01 00:58:10 -08:00
README.md Finally fix the problem where ```shell was not highlighted correctly 2024-03-01 00:58:10 -08:00
sidebars.js Add CLI docs 2024-03-01 00:19:27 -08:00

Website

This is the Docusaurus project for the Sparo website.

Development

  1. Install the monorepo dependencies using RushJS:

    rush install
    rush build
    
  2. Launch the local development server:

    cd apps/website
    rushx start
    

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Because this site is relatively small, searching is performed client-side using the docusaurus-lunr-search plugin based on Lunr.js.

Notes:

  • Site search is broken when using the localhost debug server (rushx start), but it works correctly for real deployments (rushx deploy)
  • @algolia/client-search is included in package.json dependencies only because @docusaurus/preset-classic includes it as a peer dependency.

Deployment

  1. If you will manually copy the files to a server, you can build the apps/sparo/build folder like this:

    cd apps/website
    rushx build
    
  2. To automatically deploy to GitHub Pages (as an administrator):

    # If you are using HTTPS authentication for GitHub:
    cd apps/website
    GIT_USER=<Your GitHub username> rushx deploy
    
    # If you are using SSH authentication for GitHub:
    USE_SSH=true rushx deploy
    

See also