A curated collection of resources for builders on Ritual Chain
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.
- 🎨 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
This project leverages modern web technologies for a superior developer experience:
- Next.js 15 - React framework with App Router
- React 19 - UI library with latest features
- TypeScript - Type-safe development
- Tailwind CSS 4 - Utility-first CSS framework
- Shadcn UI - Re-usable component library
- Radix UI - Accessible component primitives
- Lucide React - Beautiful icon library
- Geist Font - Vercel's modern font family
- Biome - Fast linter and formatter
- pnpm - Efficient package manager
- Vercel Analytics - Web analytics platform
react-hook-form
- Form state managementzod
- Schema validationnext-themes
- Theme managementclass-variance-authority
- CSS variant utilitiestailwind-merge
- Tailwind class merging utility
Make sure you have the following installed:
# Verify installations
node --version
pnpm --version
- Clone the repository
git clone https://github.com/RitualChain/builder-links.git
cd builder-links
- Install dependencies
pnpm install
- Start the development server
pnpm dev
- Open your browser
Navigate to http://localhost:3000 to see the application.
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 |
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
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"
/>
Update Tailwind configuration in app/globals.css
to customize the color palette:
@layer base {
:root {
--primary: your-color;
--secondary: your-color;
/* ... */
}
}
Modify SEO metadata in app/layout.tsx
:
export const metadata: Metadata = {
title: 'Your Title',
description: 'Your Description',
// ...
}
The easiest way to deploy is using Vercel:
Or manually:
- Install Vercel CLI:
pnpm install -g vercel
- Run:
vercel
- Follow the prompts
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
We welcome contributions from the community! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
- Follow the existing code style
- Write meaningful commit messages
- Test your changes thoroughly
- Update documentation as needed
- Keep PRs focused and atomic
This project is licensed under the MIT License - see the LICENSE file for details.
- Documentation: https://docs.ritual.net
- GitHub: https://github.com/RitualChain
- Discord: https://discord.gg/ritual
- Telegram: https://t.me/ritual_net
- Feedback Dashboard: https://feedback.ritual.tools
- Website: https://ritual.net
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
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 🛠️