Skip to content

MatrixDevelopment-GH/MatrixWebsite






About

Welcome to the GitHub repository for the official website for Matrix Development written in TypeScript using NextJS and Tailwind CSS. If contributing to the repository, please ensure you have prior knowledge in TypeScript/CSS and responsive web design (media queries and flexbox) and of React and/or NextJS and Tailwind CSS. This repository is primarily maintained by tncz.

You can view any changes made to the repository in #website-changelogs. You can view the website deployments at https://vercel.com/matrix-development/matrix-website.

Features

  • Written in TypeScript/TSX
  • Uses NextJS, framework for ReactJS
  • Used Tailwind CSS for styling
  • Next-Auth for Discord authentication
  • Custom built-in API with ratelimiting and authentication

Workflows

This repository current does not use any workflows.

You can view the full list of worklows here.

Installation

NodeJS v17 or higher is required. Please use yarn for installing packages, as using NPM will cause conflict warnings. If you do accidentally run npm install, delete the package-lock.json file generated. If you do not have yarn installed, run npm i yarn --save-dev -g. You can learn more about yarn here.

# Installs depedencies specified in package.json
yarn install --check-files

Note: you may get an error about engines while trying to install/uninstall packages. If this occurs, add the --ignore-engines flag to the command.

Getting started

First, run the development server:

npm run dev
# or
yarn dev

Open http://localhost:3000 with your browser to see the result.

You can start editing pages (pages folder) and components (componenents folder). The page auto-updates as you edit files within the project ffolder..

The pages/api directory is mapped to /api/*. Files in this directory are treated as API routes instead of React pages.

Scripts

  • npm run prisma:generate - Runs npx prisma generate (Ignore, can use if you know what it is)
  • npm run db:push - Runs npx prisma db push, which imposes schema file on other schema files connected to the same data base
  • npm run db:pull - Runs npx prisma db pull, which fetches schema file from other schema files connected to the same data base
  • npm run dev - Runs dotenv -e .env.local next dev, which starts the website on the development server (http://localhost:3000)
  • npm run lint - Runs ESLInt
  • npm run build - Runs next build, only for production deployment
  • npm run start - Runs next start

Learn More

To learn more about Next.js, take a look at the following resources:

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

To learn more about Tailwind CSS, take a look at the following resources:

Feel free to check out Traversy Media, a YouTube channel which provides free, interactive web development tutorials.

Deployment

As you commit changes to the repository, the Vercel integration will automatically detect these changes and attempt to deploy the website on Vercel. In this case that you do not have access, please wait patiently permission is granted for the deployment to occur. Deployment messages will show in #website-changelogs.

Contributing

If you have any issues/bus or security vulnerabilites to report, you can head over to the issues page. If you'd like to contribute to the repository, feel free to open a pull request.

To learn more about contributing, you can check out the contributing guide. Please ensure all contributions follow the code of conduct. You can view the secruity policy here.

Useful Links

Help

If you need help, feel free to reach out to unkn0wn, in the server or in a Matrix group chat. You can always check out the contributing guide if you're stuck.

License

Copyright © 2022 Matrix Development. This project is licensed under the GPL-3.0 License.

About

The official website for Matrix Development written in NextJS.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors 2

  •  
  •