🚀 Talente Spenden - Official Website

The official open-source website for Talente Spenden, a social student initiative at the Technical University of Munich (TUM) dedicated to creating a positive social impact in fields like sustainability and education.

---

✨ Live Site

Check out the live website: www.talente-spenden.com

📚 About The Project

This repository contains the source code for the digital home of Talente Spenden. It serves as a central hub for our members, partners, and anyone interested in our mission to make the world a better place. The website showcases our projects, announces upcoming events, and provides a platform for our community.

A unique feature of this website is its interactive animated gradient background, which is rendered directly on the GPU using custom vertex/fragment shaders with Three.js and React Three Fiber for a smooth and performant visual experience. The effect is based on a shader provided here:

💻 Built With

This project is built with a modern, high-performance tech stack:

• Vite - A next-generation frontend tooling.
• React - A JavaScript library for building user interfaces.
• TypeScript - A typed superset of JavaScript.
• Bun - An incredibly fast JavaScript runtime, bundler, and package manager.
• Three.js - A 3D graphics library for the web.
• React Three Fiber - A React renderer for Three.js.

Since there is currenlty no need for dynamic content management, content (especially lists) mainly is configured in the config file in the /src file. In the future there might be integrations with Content Management Systems.

🔧 Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

You need to have Bun installed on your machine.

• Bun (v1.x or higher). You can install it from bun.sh.

Installation

1. Fork the repository by clicking the 'Fork' button on the top right of this page.
2. Clone your forked repository (replace [your-repo-name] with the name of this repository):

   git clone [https://github.com/ji20/](https://github.com/ji20/)[your-repo-name].git

3. Navigate to the project directory:

   cd [your-repo-name]

4. Install dependencies using Bun:

   bun install

5. (Optional) Set up environment variables: If required, create a .env file in the root of the project and add the necessary variables.

   # Example
   VITE_API_ENDPOINT="[https://api.example.com](https://api.example.com)"
   

6. Run the development server:

   bun run dev

Your local site should now be running, typically at http://localhost:5173/!

---

🤝 How to Contribute

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

We follow the standard GitHub Fork & Pull Request workflow. Please read our CONTRIBUTING.md file for the full details on our code standards and the process for submitting pull requests to us.

1. Fork the Project
2. In your Fork, Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request in our main repository

Don't forget to give the project a star! Thanks again! ⭐

---

📜 License

Distributed under the MIT License. See the LICENSE file for more information.

---

📬 Contact & Acknowledgments

Talente Spenden - www.talente-spenden.com

This website was designed, developed and is maintained by ji20.

Project Link: https://github.com/Talente-Spenden/talente-spenden-website