All the techy dirt you need to know for moduops web site.
The project uses the SST framework. So we have a serverless hosted application that lives on AWS. SST is overkill for what we have going here but it makes dealing with AWS just about as easy as I've seen.
SST sets up as a monorepo. There are the backend services/stacks and the frontend projects. The backend sets up the "stack" with cdk to create all the required support services on AWS.
The frontend for this project is Docusaurus. Docusaurus is super easy to figure out and I think the websites created look great. Docusaurus creates a static web site from md and React files.
When doing development, navigate to the frontend directory where you can do the usual npm install and npm run start for local dev.
ModuOps docs are located in frontend/docs directory. These are markdown files for various topics within the App. You will also find the ModuOps tutorial in the docs directory.
The blog is located at frontend/blog directory. Blog post files are labeled with a date and name in the format of YYYY-MM-DD-blog_name.md.
- Project uses
pnpmfor dependency management - project is setup as a pnpm monorepo
- run the main app locally by pnpm start:moduops in the root of the project
- install all dependencies throughout the monorepo by pnpm i at the root.
- source code is managed with
gitand checked into GitHub.
There is nothing fancy about the deploy process. I have elected to NOT use any CI/CD service for this project. Deployments happen from the command line. You will need to have your AWS cli setup for deploys to work.
pnpm run deploy - deploys to dev.moduops.com
pnpm run deploy:prod - deploys to moduops.com