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

Chore: Make Better README.md #50

Merged
merged 12 commits into from
Nov 4, 2024
46 changes: 38 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,50 @@
## Getting Started
<p align="center">
<img src="public/logo.svg" alt="Trent Computer Science Club Association Logo" width="200">
</p>

This project is a simple starting point for any next.js applications. It is configured to use `tailwind css`, `typescript`, `next.js`, `eslint` and `prettier`.
# Trent Computer Science Club Association Website

In order to get started, fork this project, clone the forked repository and run `npm install`, then run `npm run dev` to start the development server.
This repository contains the source code for the official website of the Trent University Computer Science Club Association. The website serves as a central hub for club activities, announcements, resources, and information about our club's events.

## Pages

- **[Home](https://tcsca.ca)** - The main page for the website
- **[About Us](https://tcsca.ca/About)** - The page for our about us page
Kara-Zor-El marked this conversation as resolved.
Show resolved Hide resolved
- **[Events](https://tcsca.ca/Events)** - The page for our events
Kara-Zor-El marked this conversation as resolved.
Show resolved Hide resolved
- **[Contact Us](https://tcsca.ca/Contact)** - The page for our contact us page
Kara-Zor-El marked this conversation as resolved.
Show resolved Hide resolved

Kara-Zor-El marked this conversation as resolved.
Show resolved Hide resolved
## Layout and Structure

- **[pages](pages)** - This folder contains the source code for each page with `_app.tsx` and `_document.tsx` being special files that control global page content.
- **[components](components)** - This folder contains all components for the project
- **[layouts](layouts)** - This folder contains all layouts for the project
Kara-Zor-El marked this conversation as resolved.
Show resolved Hide resolved
- **[styles](styles)** - This folder contains all styles for the project
Kara-Zor-El marked this conversation as resolved.
Show resolved Hide resolved
- **[components](styles/components)** - This folder contains all styles for the components
- **[layouts](styles/layouts)** - This folder contains all styles for the layouts
- **[utils.ts](utils.ts)** - This file contains all of our global utility functions

- Additionally, in the root directly you will find a `config.ts` file and `config.yaml` file.
- `config.ts` is the backbone of our site and ensures type safety for our configuration
- `config.yaml` is the configuration file for the website

## License

Kara-Zor-El marked this conversation as resolved.
Show resolved Hide resolved
This project is licensed under the [LGPL-2.1 License](LICENSE).

## Commands

- `npm run dev` - Runs the next.js development process
- if you need to use serverless functions in your testing, run `vercel dev` instead
- `npm run build` - Runs the next.js build process
Kara-Zor-El marked this conversation as resolved.
Show resolved Hide resolved
- `npm run start` - Starts the next.js server in production mode
- `npm run lint` - Runs the linter
- `npm run format` - Runs prettier to format code

## Layout
## Contributing

We welcome contributions to this project, however, please note that we do have plans and goals, so please contact us before doing anything that heavily impacts UI or functionality. (Fixes always welcome)

## Contact Us

- `pages` - This folder contains the source code for each page with `_app.tsx` and `_document.tsx` being special files that control global page content.
- `styles` - This folder contains all styles for the project
- `components` - This folder contains all components for the project
- `_Static` - This folder will contain any static code or files for the project
- The best way to contact our devs is via Discord, you can join our Discord server [here](https://discord.gg/serea2sPAd).
- Additionally, you can use the contact us page [here](https://tcsca.ca/Contact).
Loading