Skip to content

RitualChain/builder-links

Repository files navigation

Builder Links

🔗 Ritual Chain Developer Hub

A curated collection of resources for builders on Ritual Chain

Visit Live Site »


📖 Overview

Builder Links is a modern, centralized developer hub that serves as the primary gateway for builders on Ritual Chain. This beautifully designed landing page provides quick access to essential resources, documentation, community channels, and developer tools needed to build decentralized AI applications on the Ritual Chain blockchain.

✨ Key Features

  • 🎨 Modern UI/UX - Responsive bento grid layout with smooth animations and dark mode support
  • 📚 Centralized Resources - Quick access to documentation, GitHub, Discord, and other essential links
  • 🚀 Fast Performance - Built with Next.js 15 App Router for optimal loading speeds
  • ♿ Accessible - WCAG compliant components using Radix UI primitives
  • 📱 Mobile First - Fully responsive design that works seamlessly across all devices
  • 🔍 SEO Optimized - Complete metadata and Open Graph tags for better discoverability
  • 📊 Analytics Ready - Integrated with Vercel Analytics for tracking user engagement

🛠️ Tech Stack

This project leverages modern web technologies for a superior developer experience:

Core Framework

Styling & UI

Developer Tools

Additional Libraries

  • react-hook-form - Form state management
  • zod - Schema validation
  • next-themes - Theme management
  • class-variance-authority - CSS variant utilities
  • tailwind-merge - Tailwind class merging utility

🚀 Getting Started

Prerequisites

Make sure you have the following installed:

# Verify installations
node --version
pnpm --version

Installation

  1. Clone the repository
git clone https://github.com/RitualChain/builder-links.git
cd builder-links
  1. Install dependencies
pnpm install
  1. Start the development server
pnpm dev
  1. Open your browser

Navigate to http://localhost:3000 to see the application.


📜 Available Scripts

Command Description
pnpm dev Start development server on localhost:3000
pnpm build Create optimized production build
pnpm start Start production server
pnpm lint Run linting checks

📁 Project Structure

builder-links/
├── app/                      # Next.js App Router
│   ├── layout.tsx           # Root layout with metadata
│   ├── page.tsx             # Home page
│   └── globals.css          # Global styles
├── components/              # React components
│   ├── ui/                  # Shadcn UI components
│   ├── header.tsx           # Navigation header
│   ├── hero-section.tsx     # Hero component
│   ├── bento-grid.tsx       # Resource grid
│   ├── bento-card.tsx       # Individual cards
│   └── footer.tsx           # Site footer
├── hooks/                   # Custom React hooks
├── lib/                     # Utility functions
├── public/                  # Static assets
│   ├── icons/               # App icons
│   └── og-image.png         # Open Graph image
├── styles/                  # Additional stylesheets
├── biome.json              # Biome configuration
├── components.json         # Shadcn UI config
├── next.config.mjs         # Next.js configuration
├── package.json            # Project dependencies
├── pnpm-lock.yaml          # Lock file
├── postcss.config.mjs      # PostCSS config
├── tailwind.config.ts      # Tailwind CSS config
└── tsconfig.json           # TypeScript config

🎨 Customization

Adding New Resource Cards

Edit components/bento-grid.tsx to add new resource cards:

<BentoCard
  title="Your Resource"
  description="Description of your resource"
  icon={YourIcon}
  className="md:col-span-1"
  href="https://your-link.com"
/>

Modifying Theme Colors

Update Tailwind configuration in app/globals.css to customize the color palette:

@layer base {
  :root {
    --primary: your-color;
    --secondary: your-color;
    /* ... */
  }
}

Updating Metadata

Modify SEO metadata in app/layout.tsx:

export const metadata: Metadata = {
  title: 'Your Title',
  description: 'Your Description',
  // ...
}

🌐 Deployment

Deploy to Vercel (Recommended)

The easiest way to deploy is using Vercel:

Deploy with Vercel

Or manually:

  1. Install Vercel CLI: pnpm install -g vercel
  2. Run: vercel
  3. Follow the prompts

Deploy to Other Platforms

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

  • Netlify: Connect your repository and deploy
  • AWS Amplify: Follow the Next.js deployment guide
  • Railway: One-click deployment from GitHub
  • Self-hosted: Run pnpm build && pnpm start

🤝 Contributing

We welcome contributions from 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

Development Guidelines

  • Follow the existing code style
  • Write meaningful commit messages
  • Test your changes thoroughly
  • Update documentation as needed
  • Keep PRs focused and atomic

📝 License

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


🔗 Important Links


💬 Support

Need help? Have questions?

  • Discord: Join our Discord community for real-time support
  • GitHub Issues: Report bugs or request features
  • Feedback Dashboard: Share ideas and vote on feature requests

🙏 Acknowledgments

Built with ❤️ by the Ritual team and community contributors.

Special thanks to:

  • Vercel for Next.js and hosting
  • Shadcn for the component library
  • Radix UI for accessible primitives
  • All our amazing contributors

Made for builders, by builders 🛠️

Ritual ChainDocumentationGitHub

About

Links for developers building on Ritual Chain.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published