Skip to content

Minkaill/commit-caster-web

Repository files navigation

CommitCaster πŸš€

Automatically publish AI-powered posts about your GitHub commits to Telegram

A stunning landing page built with the Bitcoin DeFi aesthetic – featuring luminescent energy, mathematical precision, and layered depth that makes your code broadcasts feel like digital gold.

Bitcoin Orange React TypeScript Tailwind CSS


✨ Features

🎨 Design System

  • Bitcoin DeFi Aesthetic – True void backgrounds (#030304) with Bitcoin orange (#F7931A) and digital gold (#FFD600) accents
  • Colored Glow Shadows – No black shadows, only orange/gold luminescence
  • Glass Morphism – Translucent panels with backdrop blur effects
  • Grid Patterns – Subtle blockchain-inspired network backgrounds
  • 3D Animations – Spinning orbital rings, floating cards, pulsing indicators

🌍 Internationalization

  • English and Russian language support
  • Elegant floating language switcher (top-right corner)
  • Persistent language selection via localStorage
  • Full translation coverage across all sections

πŸ“± Responsive Design

  • Mobile-first approach
  • Smooth animations and interactions
  • Touch-friendly buttons (44px+ targets)
  • Adaptive typography scaling

🧩 Component Library

  • Built with Shadcn/ui patterns
  • Custom Bitcoin DeFi styled components:
    • Button – Gradient pill buttons with glow effects
    • Card – Elevated surfaces with hover animations
    • Input – Minimalist bottom-border inputs
  • Type-safe variants using class-variance-authority

πŸ› οΈ Tech Stack

Technology Purpose
Vite Lightning-fast dev server & build tool
React 18 UI component library
TypeScript Type safety & developer experience
Tailwind CSS v3 Utility-first styling
i18next Internationalization framework
Lucide React Beautiful, consistent icons
CVA Type-safe component variants

Typography

  • Space Grotesk – Headings (geometric grotesque with technical character)
  • Inter – Body text (highly legible, screen-optimized)
  • JetBrains Mono – Data & stats (precision monospace)

πŸš€ Getting Started

Prerequisites

  • Node.js 18+ and npm

Installation

# Clone the repository
git clone <your-repo-url>
cd commitcasterweb

# Install dependencies
npm install

# Start development server
npm run dev

The app will be available at http://localhost:5173/ (or 5174 if 5173 is in use)

Build for Production

# Create optimized production build
npm run build

# Preview production build locally
npm run preview

πŸ“ Project Structure

commitcasterweb/
β”œβ”€β”€ public/                      # Static assets
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ ui/                  # Base UI components
β”‚   β”‚   β”‚   β”œβ”€β”€ button.tsx       # Button with gradient & glow
β”‚   β”‚   β”‚   β”œβ”€β”€ card.tsx         # Card with hover lift effect
β”‚   β”‚   β”‚   └── input.tsx        # Minimalist input field
β”‚   β”‚   β”œβ”€β”€ sections/            # Landing page sections
β”‚   β”‚   β”‚   β”œβ”€β”€ Hero.tsx         # Hero with 3D orb animation
β”‚   β”‚   β”‚   β”œβ”€β”€ Features.tsx     # Feature grid with icons
β”‚   β”‚   β”‚   β”œβ”€β”€ HowItWorks.tsx   # Blockchain-style timeline
β”‚   β”‚   β”‚   β”œβ”€β”€ Trust.tsx        # Stats & testimonials
β”‚   β”‚   β”‚   └── Footer.tsx       # Footer with links
β”‚   β”‚   └── LanguageSwitcher.tsx # Floating language toggle
β”‚   β”œβ”€β”€ lib/
β”‚   β”‚   β”œβ”€β”€ i18n.ts              # i18next configuration
β”‚   β”‚   └── utils.ts             # cn() utility for class merging
β”‚   β”œβ”€β”€ locales/
β”‚   β”‚   β”œβ”€β”€ en.json              # English translations
β”‚   β”‚   └── ru.json              # Russian translations
β”‚   β”œβ”€β”€ App.tsx                  # Main app component
β”‚   β”œβ”€β”€ main.tsx                 # App entry point
β”‚   └── index.css                # Global styles & Tailwind
β”œβ”€β”€ tailwind.config.js           # Tailwind + design tokens
β”œβ”€β”€ tsconfig.json                # TypeScript configuration
β”œβ”€β”€ vite.config.ts               # Vite configuration
└── package.json                 # Dependencies & scripts

🎨 Design System Overview

Color Palette

{
  background: '#030304',      // True Void
  surface: '#0F1115',         // Dark Matter
  foreground: '#FFFFFF',      // Pure Light
  muted: '#94A3B8',           // Stardust
  border: '#1E293B',          // Dim Boundary
  primary: '#F7931A',         // Bitcoin Orange
  'primary-burnt': '#EA580C', // Burnt Orange
  'primary-gold': '#FFD600',  // Digital Gold
}

Custom Shadows

shadow-glow-orange      β†’ 0 0 20px -5px rgba(234, 88, 12, 0.5)
shadow-glow-orange-lg   β†’ 0 0 30px -5px rgba(247, 147, 26, 0.6)
shadow-glow-gold        β†’ 0 0 20px rgba(255, 214, 0, 0.3)
shadow-card-elevation   β†’ 0 0 50px -10px rgba(247, 147, 26, 0.1)

Animations

  • animate-float – Smooth vertical floating (8s loop)
  • animate-spin-slow – 10s rotation for outer ring
  • animate-spin-reverse – 15s reverse rotation for inner ring
  • animate-bounce – Staggered bouncing for floating cards

🌍 Adding New Languages

  1. Create a new translation file in src/locales/:

    src/locales/es.json  # Spanish example
  2. Add translations following the existing structure:

    {
      "hero": {
        "badge": "Impulsado por IA",
        "title": "Transmite Tu CΓ³digo",
        ...
      }
    }
  3. Register the language in src/lib/i18n.ts:

    import es from '@/locales/es.json'
    
    const resources = {
      en: { translation: en },
      ru: { translation: ru },
      es: { translation: es }  // Add here
    }
  4. Update the LanguageSwitcher.tsx component to include your new language option.


🎯 Key Design Principles

1. Luminescent Energy

Light emanates from interactive elements. Shadows are colored (orange/gold), never pure black.

2. Mathematical Precision

Ultra-thin 1px borders, monospace fonts for data, strict geometric alignment.

3. Layered Depth

3D space through glass morphism, colored glows, and backdrop blurβ€”digital depth, not physical.

4. Textured Void

Backgrounds breathe with grid patterns, radial gradients, and subtle noise textures.

5. Trust Through Design

High contrast, clear hierarchy, and technical precision communicate security and reliability.


🀝 Contributing

Contributions are welcome! Please follow these guidelines:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Follow the existing code style and design system
  4. Ensure all text is translatable (use i18next)
  5. Test on mobile and desktop
  6. Commit your changes: git commit -m 'Add amazing feature'
  7. Push to the branch: git push origin feature/amazing-feature
  8. Open a Pull Request

πŸ“ Scripts

Command Description
npm run dev Start development server with HMR
npm run build Build for production (output to dist/)
npm run preview Preview production build locally
npm run lint Run ESLint for code quality

πŸ“„ License

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


πŸ™ Acknowledgments

  • Bitcoin for the iconic orange that powers this design
  • Tailwind CSS for the utility-first philosophy
  • Shadcn/ui for component architecture patterns
  • Lucide for beautiful, consistent icons
  • i18next for seamless internationalization

πŸ“§ Contact

For questions, feedback, or collaboration:


Built with ⚑ by developers, for developers

Made with the Bitcoin DeFi aesthetic – where code meets digital gold ✨

About

Automatically publish AI-powered posts about your GitHub commits to Telegram

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors