Skip to content

Gyanranjan-Priyam/codebreakers

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

21 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Codebreakers GCEK

Codebreakers Logo

Official website for the Codebreakers Coding Club at Government College of Engineering, KALAHANDI

Next.js React TypeScript Tailwind CSS

Breaking codes. Building futures.


🌟 Overview

Codebreakers is the premier coding club at Government College of Engineering, KALAHANDI (GCEK). This repository contains the source code for our official website, showcasing our team, events, projects, and activities.

The website features a futuristic Tron-inspired design powered by The GridCN UI library, creating an immersive digital experience that reflects our passion for cutting-edge technology.

Key Features

  • πŸ‘₯ Team Showcase - Meet our core members, coordinators, and alumni
  • 🎯 Events Portal - Browse past and upcoming events including hackathons, ideathons, workshops, and coding sessions
  • πŸš€ Projects Gallery - Explore innovative projects built by our members
  • πŸ“§ Contact Page - Get in touch with the Codebreakers team
  • 🎨 Tron-Inspired UI - Immersive design with 3D effects, neon glows, and HUD elements
  • πŸ”’ TypeScript - Full type safety with comprehensive TypeScript definitions
  • 🎭 Theme System - Multiple Greek god-inspired themes (Ares, Tron, Clu, Athena, Aphrodite, Poseidon)

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm, pnpm, or yarn

Installation

# Clone the repository
git clone https://github.com/codebreakers-gcek/codebreakers.git
cd codebreakers

# Install dependencies
npm install
# or
pnpm install

# Run the development server
npm run dev
# or
pnpm dev

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

Build for Production

npm run build
npm start
# or
pnpm build
pnpm start

πŸ“¦ Project Structure

codebreakers-web/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/                     # Next.js app directory
β”‚   β”‚   β”œβ”€β”€ _components/         # Shared components (error, not-found, etc.)
β”‚   β”‚   β”œβ”€β”€ contact/             # Contact page
β”‚   β”‚   β”œβ”€β”€ developers/          # Developer pages
β”‚   β”‚   β”‚   β”œβ”€β”€ alumni/          # Alumni showcase
β”‚   β”‚   β”‚   β”œβ”€β”€ devs/            # Current developers
β”‚   β”‚   β”‚   └── teams/           # Team structure
β”‚   β”‚   β”œβ”€β”€ events/              # Events pages
β”‚   β”‚   β”‚   β”œβ”€β”€ 9-lock-challenges/
β”‚   β”‚   β”‚   β”œβ”€β”€ codeCHEF/
β”‚   β”‚   β”‚   β”œβ”€β”€ hackathon/
β”‚   β”‚   β”‚   β”œβ”€β”€ ideathon/
β”‚   β”‚   β”‚   β”œβ”€β”€ sessions/
β”‚   β”‚   β”‚   └── workshop/
β”‚   β”‚   β”œβ”€β”€ projects/            # Projects showcase
β”‚   β”‚   β”œβ”€β”€ page.tsx             # Homepage
β”‚   β”‚   β”œβ”€β”€ layout.tsx           # Root layout
β”‚   β”‚   └── globals.css          # Global styles & themes
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ ui/                  # shadcn/ui base components
β”‚   β”‚   β”œβ”€β”€ thegridcn/           # Tron-inspired UI components
β”‚   β”‚   β”œβ”€β”€ theme/               # Theme provider & switcher
β”‚   β”‚   β”œβ”€β”€ showcase/            # Component showcase sections
β”‚   β”‚   β”œβ”€β”€ layout/              # Layout components
β”‚   β”‚   └── website/             # Website-specific components
β”‚   β”œβ”€β”€ data/                    # Data files
β”‚   β”‚   β”œβ”€β”€ devData.ts           # Team members data
β”‚   β”‚   β”œβ”€β”€ testimonials.ts      # Testimonials
β”‚   β”‚   └── index.ts             # Data exports
β”‚   β”œβ”€β”€ hooks/                   # Custom React hooks
β”‚   β”œβ”€β”€ lib/                     # Utility functions
β”‚   └── styles/                  # Additional styles
β”œβ”€β”€ public/                      # Static assets
β”‚   β”œβ”€β”€ assets/                  # Images and media
β”‚   └── manifest.json            # PWA manifest
└── components.json              # shadcn/ui configuration

Main Pages

  • Home (/) - Landing page with club overview and highlights
  • Developers
    • /developers/devs - Current team members
    • /developers/teams - Team structure
    • /developers/alumni - Alumni network
  • Events
    • /events/hackathon - Hackathon information
    • /events/ideathon - Ideathon details
    • /events/workshop - Workshop series
    • /events/sessions - Coding sessions
    • /events/codeCHEF - CodeCHEF events
    • /events/9-lock-challenges - 9-Lock coding challenges
  • Projects (/projects) - Showcase of club projects
  • Contact (/contact) - Get in touch with the team

🎨 UI & Design System

The website is built using The GridCN - a Tron-inspired design system with 50+ components and 6 unique themes.

Available Themes

Theme Color Inspiration
Ares Red (#ff3333) God of War - Main theme
Tron Cyan (#00d4ff) User - Classic Tron aesthetic
Clu Orange (#ff6600) Program - Antagonist theme
Athena Gold (#ffd700) Goddess of Wisdom
Aphrodite Pink (#ff1493) Goddess of Love
Poseidon Blue (#0066ff) God of Sea

Each theme includes:

  • Custom color palettes with OKLCH color space
  • Neon glow effects matching the theme color
  • 3D grid effects and HUD elements
  • Scanline overlays and pulsing animations

🎯 Features

Team Management

  • Core Members - Secretary, Assistant Secretary, Treasurer
  • Coordinators - Technical and Event coordinators
  • Alumni Network - Showcase of past members
  • Dynamic team cards with profiles and social links

Events System

  • Multi-event support (Hackathons, Ideathons, Workshops, Sessions)
  • Event details and registration information
  • Past event archives

Projects Showcase

  • Gallery of club projects
  • Project details and documentation
  • Team member contributions

Interactive UI

  • 3D grid backgrounds with Three.js
  • Tron-style data cards and HUD elements
  • Animated transitions and hover effects
  • Responsive design for all devices

πŸ› οΈ Tech Stack

πŸ’» Development

Adding Team Members

Edit /src/data/devData.ts to add or update team members:

export const coreMembers = [
  {
    image: "https://your-image-url.jpg",
    title: "Your Name",
    subtitle: "Your Role",
    handle: "@yourhandle",
    borderColor: "#3B82F6",
    gradient: "linear-gradient(145deg, #3B82F6, #000)",
    url: "https://your-portfolio.com",
  },
  // Add more members...
];

Customizing Themes

Themes are defined in /src/app/globals.css. You can customize colors, glows, and effects:

[data-theme="ares"] {
  --primary: 2 90% 60%;
  --glow: 2 100% 50%;
  /* ... more theme variables */
}

Adding Events

Create new event pages in /src/app/events/[event-name]/page.tsx:

export default function EventPage() {
  return (
    <div>
      <h1>Your Event</h1>
      {/* Event content */}
    </div>
  );
}

🚒 Deployment

Deploy on Vercel

The easiest way to deploy is using the Vercel Platform:

  1. Push your code to GitHub
  2. Import the repository in Vercel
  3. Configure environment variables (if any)
  4. Deploy!

Environment Variables

Create a .env.local file for local development:

# Add any required environment variables here
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Other Platforms

This is a standard Next.js application and can be deployed to any platform that supports Next.js:

🀝 Contributing

We welcome contributions from Codebreakers members and the community! Here's how you can help:

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

Contribution Guidelines

  • Follow the existing code style
  • Write meaningful commit messages
  • Test your changes locally before submitting
  • Update documentation as needed

πŸ“„ License

This project is open source and available under the MIT License.

πŸ™ Acknowledgments

  • Codebreakers GCEK - All members who contributed to this project
  • The GridCN - For the amazing Tron-inspired UI library
  • shadcn/ui - For the component library foundation
  • Radix UI - For accessible primitives
  • Three.js - For 3D capabilities

πŸ‘₯ Team

Core Members

  • Secretary - Podili Biswajit
  • Assistant Secretary - Chayakanta Maharana
  • Treasurer - Sambhunath Meher

Coordinators

  • Motivator & Event Coordinator - R. Pradyota Reddy
  • Technical Coordinator - Biplab Jena

πŸ“ž Contact & Support

  • 🌐 Website: Visit our website
  • πŸ“§ Email: Contact us through the Contact Page
  • πŸ’¬ GitHub Issues: For technical issues and suggestions

Built with ❀️ by Codebreakers GCEK

Breaking codes. Building futures.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors