tiktok-sparo/apps/website/README.md
2024-02-26 21:27:10 -08:00

1.5 KiB

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