Computer Science Club of the University of Waterloo's website.
https://csclub.uwaterloo.ca
Shahan Nedadahandeh
bb78a3d53d
continuous-integration/drone/push Build is passing
Details
Update: In order to solve the issues discussed below, we decided to put the warnings in a json file, since they can be easily imported into a javascript file and webpack automatically bundles them with the client side app, so no static props is needed. __________ To get the warning data, since it is something that needs to be on all pages, it makes sense for the component to go in the app.js file (similar to the nav bar). However, next.js has a cumbersome issue that it does not support getStaticProps in the app.ts file (and getStaticProps only works in page files), thus we have no way of requesting the warning data easily in the \<WarningHeader\> Component. (https://github.com/vercel/next.js/discussions/10949) Here is my solution: - Request the warning data on the client side through the use of an api. - I made a warning api (/api/currentWarning) which sends a json of the current warning - Advantage: warnings will always be up to date since it is recalculated on every request - Advantage: It can potentially incorporate with other CSC services who might need to know about the warning (eg linktree?) - Disadvantage: can get expensive if we have a lot of warnings, to fix this I can cache the current warning and only re-read the files every 24h if this is a problem, but if we don’t have that many warnings I think it should be fine - Disadvantage: listed below: The current problem with what I implemented is that it doesn’t build in the production environment: - The way we build the website, when we call “next export” that disables any api endpoints. - According to this https://github.com/vercel/vercel/discussions/6551, if we want to allow api endpoints, we have to just do “next build”. This has implications that the site won’t be completely static anymore, but the other solutions also have similar problems ( though the GitHub post says that next will still optimize for static with only next build). Another advantage of allowing api’s is that maybe in the future we will implement other features where an api might be useful. If you want to try it out, my branch works fine locally (when just running npm run dev or npm run build”) Other possible solutions: - Use getInitialProps inside _app.js, but this has the downside that it will “disable Automatic Static Optimization in pages without Static Generation.” (https://nextjs.org/docs/advanced-features/custom-app), which I believe will slow the whole site down, but, we will be able to still use the old build command I think, I am not sure of the full effect of this. - However, implementing this would also be relatively simple. - Add the warning request to the getStaticProps of every single page, possibly through some wrapper component around every single page, this has the disadvantage that we need to do a lot of refactoring of all the pages of the site and cant use the intended “_app.ts” wrapper. - Add warning header only to the homepage (or maybe one or two other important pages). Co-authored-by: shahanneda <shahan.neda@gmail.com> Reviewed-on: #394 Reviewed-by: Amy <a258wang@csclub.uwaterloo.ca> |
||
|---|---|---|
| .vscode | ||
| components | ||
| content | ||
| hooks | ||
| images | ||
| lib | ||
| pages | ||
| public | ||
| scripts | ||
| .drone.yml | ||
| .eslintignore | ||
| .eslintrc.js | ||
| .gitignore | ||
| README.md | ||
| deploy-demo.bash | ||
| deploy.sh | ||
| next-env.d.ts | ||
| next.config.js | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.json | ||
| renovate.json | ||
| tsconfig.json | ||
| types.d.ts | ||
| utils.ts | ||
README.md
Development
Dependencies
Make sure that you have node >= 14 and npm >= 7. Node 14 ships with npm v6,
so if you're using node 14, you would need to upgrade npm. Alternatively you
could also upgrade to node 16, which ships with npm 7.
How to upgrade npm: npm i -g npm
Local
npm installto install project dependenciesnpm run devto run the dev server (http://localhost:3000)
Production
npm installto install project dependenciesnpm run buildto generate html/css/jsnpm run exportto move the built files (along with assets in the public directory) to the/outdirectory- Use your favourite web server to host the files in the
/outdirectory. (A very simple one would bepython -m http.server- not sure if it should actually be used for production :P)
Deploy
groups(make sure you're in thewwwgroup)curl -o- https://git.csclub.uwaterloo.ca/www/www-new/raw/branch/main/deploy.sh | bash(run oncaffeine)