Neuland Ingolstadt e.V. Website

A stylish, modern, and open-source website for Neuland Ingolstadt e.V. – built with Next.js, React, and Bun.

🚀 Quick Start • 📋 Features • 📦 Technology Stack • 🤝 Contributing

---

🌟 Overview

Neuland Ingolstadt e.V. Website is the digital home for our association, showcasing our activities, events, and community engagement. Built with the latest web technologies, it offers a beautiful, responsive, and accessible experience for members and visitors alike.

---

📑 Table of Contents

• Overview
• Quick Start
• Features
• Technology Stack
• Development
• Code Quality
• Contributing
• License

---

🚀 Quick Start

Prerequisites

• Node.js
• Bun (for development)

Installation

# Clone the repository
git clone https://github.com/neuland-ingolstadt/neuland-website.git
cd neuland-website

# Install dependencies
bun install

Development

Start the development server:

bun run dev

The site will be available at http://localhost:3000

---

📋 Features

• Modern UI/UX: Clean, responsive design with dark/light mode
• Blog: Markdown-powered blog with tags, previews, and featured posts
• Events: Upcoming events section with calendar integration
• Projects: Showcase of association projects
• Accessibility: Keyboard navigation and WCAG compliance
• Internationalization: Support for multiple languages (currently German and English)
• SEO Optimized: Fast, discoverable, and shareable
• Open Source: MIT licensed and community-driven

---

📦 Technology Stack

Component	Technology	Purpose
Frontend	Next.js, React, TypeScript	Modern web app with SSR & SSG
Styling	Tailwind CSS, CSS Modules	Responsive, utility-first styling
Bundler	Bun	Fast JS runtime and package manager
Markdown	Contentlayer, MDX	Blog content and static site generation
UI	Custom Components	Reusable, accessible UI elements

---

🛠️ Development

• Start Dev Server:

  bun run dev

• Build for Production:

  bun run build

• Start Production Server:

  bun run start

---

🧹 Code Quality

• Linting:

  bun run lint

• Formatting:

  bun run fmt

---

🤝 Contributing

We welcome contributions from everyone! To get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to your branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Code Style:

• Use Biome for linting and formatting
• Follow conventional commit messages

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

Made with ❤️ by Robert Eggl and the Neuland Ingolstadt e.V. team