Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Quick Start Guide #339

Open
DavieReid opened this issue Apr 27, 2023 · 2 comments
Open

Quick Start Guide #339

DavieReid opened this issue Apr 27, 2023 · 2 comments
Labels
documentation Improvements or additions to documentation

Comments

@DavieReid
Copy link
Contributor

DavieReid commented Apr 27, 2023

Create a new Quick Start Guide for creating a new mosaic site.

Probably best to create a new generator that does not add mosaic specific sources but instead adds some sample docs.

Prerequisites

yarn v1
Node v 16+

Steps

  1. yarn init - to create a package.json
  2. yarn add @jpmorganchase/mosaic-create-site -W
  3. yarn mosaic-create-site init
  4. yarn mosaic-create-site create -i -o site
  5. cd site
  6. yarn build
  7. yarn serve

NOTES

When adding to an existing monorepo as a new site package, had to run prettier on the generated site.

@origami-z
Copy link
Contributor

Maybe need to add yarn being pre-requisite..? Yarn init may also be a valid command if the rest is all yarn?

@DavieReid DavieReid added the documentation Improvements or additions to documentation label Apr 27, 2023
@Unnati-Sadh
Copy link

I want to contribute to this repo, the following steps can be followed:
Quick Start Guide: Creating a New Mosaic Site

Steps:

  1. Initialize a new project:
    Run the following command to create a package.json file:

yarn init

  1. Install the Mosaic Create Site package:
    Add the @jpmorganchase/mosaic-create-site package as a dev dependency:

yarn add @jpmorganchase/mosaic-create-site -D

  1. Initialize the Mosaic site:
    Run the initialization command to set up the Mosaic site structure:

yarn mosaic-create-site init

  1. Create sample documents:
    Use the following command to generate sample documents on the site:

yarn mosaic-create-site create -i -o site

Note: The -i flag indicates that the generator should not add mosaic-specific sources but instead add sample documents.

  1. Navigate to the site directory:
    Change into the newly created site directory:

cd site

  1. Build the Mosaic site:
    Use the following command to build the Mosaic site:

yarn build

  1. Serve the Mosaic site:
    Start a local development server to serve the Mosaic site:

yarn serve

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

3 participants