{"id":26213068,"url":"https://github.com/dropsource/monarch_site","last_synced_at":"2026-02-11T16:02:19.921Z","repository":{"id":37082932,"uuid":"318662472","full_name":"Dropsource/monarch_site","owner":"Dropsource","description":"Monarch website","archived":false,"fork":false,"pushed_at":"2024-02-21T20:32:06.000Z","size":98966,"stargazers_count":1,"open_issues_count":8,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-02-22T14:33:43.155Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dropsource.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/contributing.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-04T23:54:20.000Z","updated_at":"2024-05-29T22:16:30.985Z","dependencies_parsed_at":"2024-01-21T01:28:51.665Z","dependency_job_id":"fb48cfb2-bfc8-4b5f-9254-0f25e319a0c4","html_url":"https://github.com/Dropsource/monarch_site","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dropsource%2Fmonarch_site","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dropsource%2Fmonarch_site/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dropsource%2Fmonarch_site/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dropsource%2Fmonarch_site/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dropsource","download_url":"https://codeload.github.com/Dropsource/monarch_site/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243188240,"owners_count":20250457,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-12T09:17:36.028Z","updated_at":"2026-02-11T16:02:19.875Z","avatar_url":"https://github.com/Dropsource.png","language":"HTML","readme":"# monarch_site\n\nThe monarch_site is built using [Docusaurus 2](https://v2.docusaurus.io/), a \nmodern static website generator.\n\n## Installation\n\n```\nyarn install\n```\n\nMake sure you have latest node.js.\n\n## Local Development\n\n```\nyarn run start --host 0.0.0.0\n```\n\nThis command starts a local development server and open up a browser window. Most \nchanges are reflected live without having to restart the server. The `--host` flag\nwill allow access to your dev site from within the local network.\n\n## Build\n\n```\nyarn build\n```\n\nThis command generates static content into the `build` directory and can be served \nusing any static contents hosting service.\n\n\n## Image Processing\n\n### Image Compression\nCompress the images before you add them to this repo. Here is a few options to compress images:\n\n- Use a website, like [Compress PNG](https://compresspng.com/) \n- We seem to get better results with with compression apps like \"mini PNG Lite\" which you can get from the macOS App Store.\n- Use a cli tool like [pngquant](https://pngquant.org/)\n\nIf you use `pngquant`, this command is usually enough:\n```\npngquant *.png\n```\n\n### static/assets (not content versioned)\nThe command `yarn build` moves `static/assets` to `build/assets`. It does the \nsame thing with `static/gifs` and `static/img`. \n\nMoving forward only use the `static/assets` directory.\n\nImages in the `static/assets` directory do not get content versioned. Their cache \nbusting is more difficult but they are good to use for content which should be\nheavily cached, like landing page images, or open graph images.\n\nAvoid changing the content of images in the `static/assets` directory. These images \nare cached and replacing the content may not bust the cache since the file name will \nbe the same. Instead of changing the image content, add a new image and change the \nreference to that image. After deploying the new image and after verifying the new \nimage is properly deployed, then the old image can be deleted.\n\n### docs/assets and blog/assets (content versioned)\nImages in the `docs/assets` or `blog/assets` are usually referenced via the \n`import` statement in an mdx or js file. The import statement will content \nversion those images. Unfortunately, after `yarn build`, the import statement moves \nthem to the `build/assets/images` directory, which is confusing. Beware of that.\n\n### Open graph images\nIdeally every blog post and newsletter should have its own open graph image. \nIf you are adding an open graph image, then make sure its dimensions are \n1.9:1 or 2:1. A width of 1200 or 1500 pixels is ok. Make sure to compress it, see [[#Image Compression]].\n\nYou can use the page `/opengraph` to draft your own open graph image. Edit the page\nvia opengraph.js\n\n## Styles\nTo see the generated css go to: http://localhost:3000/styles.css\n\n\n## Deployments\n\n### Deployment PROD\n\nWe use render.com to host the production monarch_site. The production site \ndeploys the contents of the `master` branch in Github. The monarch automation edits the master branch when it generates a new monarch version.\n\nAsk someone in the team for the contents of the `.deploy_hook` file. Then run:\n```\nsh deploy.sh\n```\n\nThen go to: \n- https://monarchapp.io/\n- https://monarch-site.onrender.com/\n\n### Deployment DEV\n\nWe also have a dev site on render.com which deploys from the `dev` branch \nin Github. The monarch automation edits the dev branch when it runs dev builds.\n\nMake sure you are using the deploy hook for the site you want to deploy to.\n```\nsh deploy_dev.sh\n```\nThen go to: \n- https://monarch-site-dev.onrender.com/\n\n### Staging Site\nThere is also a staging site, which we can use to collaborate on content. The master and\ndev branch have protection rules in Github. Content collaborators could submit changes \nto the staging branch which will then need to be merged to dev or master.\n\nThe staging site deploys from the `staging` branch. The staging site is \nset up under a shared account in render.com. \n\n- The shared login is ftrigoso+marketing@dropsource.com.\n- The staging site is hosted at: https://monarch-site-staging.onrender.com/\n- To deploy to staging, login to render.com and do a manual deploy.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdropsource%2Fmonarch_site","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdropsource%2Fmonarch_site","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdropsource%2Fmonarch_site/lists"}