Skip to content

Showcasing our open-source ecosystem, projects, mission, and vision. Built with Next.js, TypeScript, Tailwind CSS, and Framer Motion.

Notifications You must be signed in to change notification settings

TIVerse/TIVerse.github.io

Repository files navigation

TIVerse - Tonmoy Infrastructure & Vision

A modern, production-ready website for TIVerse, showcasing our open-source ecosystem, projects, mission, and vision. Built with Next.js, TypeScript, Tailwind CSS, and Framer Motion.

TIVerse Website

πŸš€ Features

  • Modern Design: Clean, developer-focused UI with glassmorphism effects and subtle animations
  • Responsive: Fully responsive design optimized for all devices
  • Performance: Built with Next.js 13+ App Router for optimal performance
  • Accessibility: WCAG compliant with semantic HTML and keyboard navigation
  • SEO Optimized: Complete meta tags, Open Graph, and structured data
  • Dark/Light Mode: System-aware theme switching with persistent preferences
  • Type Safety: Full TypeScript coverage with strict mode enabled
  • Animation: Smooth animations and micro-interactions with Framer Motion

πŸ› οΈ Tech Stack

  • Framework: Next.js 13+ (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS + Shadcn/UI
  • Icons: Lucide React
  • Animations: Framer Motion
  • Theme: next-themes
  • Deployment: Vercel (optimized build configuration)

πŸ“ Project Structure

tiverse-website/
β”œβ”€β”€ app/                    # Next.js App Router
β”‚   β”œβ”€β”€ about/             # About page
β”‚   β”œβ”€β”€ contact/           # Contact form
β”‚   β”œβ”€β”€ projects/          # Projects showcase
β”‚   β”œβ”€β”€ research/          # R&D research papers
β”‚   β”‚   β”œβ”€β”€ [slug]/       # Individual research document
β”‚   β”‚   └── page.tsx      # Research listing
β”‚   β”œβ”€β”€ layout.tsx         # Root layout
β”‚   β”œβ”€β”€ page.tsx           # Homepage
β”‚   └── not-found.tsx      # 404 page
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ ui/                # Shadcn/UI components
β”‚   β”œβ”€β”€ layout/            # Layout components (header, footer)
β”‚   β”œβ”€β”€ markdown-renderer.tsx # Markdown renderer with TOC
β”‚   └── theme-provider.tsx # Theme provider
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ research.ts        # Research document utilities
β”‚   └── utils.ts           # Utility functions
β”œβ”€β”€ research-documents/    # Markdown research papers
β”œβ”€β”€ public/                # Static assets
└── styles/
    └── globals.css        # Global styles

πŸš€ Getting Started

Prerequisites

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

Installation

  1. Clone the repository:
git clone https://github.com/tiverse/website.git
cd tiverse-website
  1. Install dependencies:
npm install
# or
yarn install
# or
pnpm install
  1. Run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev
  1. Open http://localhost:3000 in your browser.

🎨 Customization

Brand Colors

The website uses TIVerse's signature color palette defined in tailwind.config.ts:

  • Primary: #4F46E5 (Indigo 600)
  • Secondary: Various shades of purple and indigo
  • Accent: Complementary colors for highlights

Content Updates

  • Projects: Update the projects array in app/projects/page.tsx
  • Research Papers: Add markdown files to research-documents/ directory
  • Company Info: Modify content in app/about/page.tsx

Styling

The website uses Tailwind CSS with custom design tokens. Key styling files:

  • app/globals.css - Global styles and CSS variables
  • tailwind.config.ts - Tailwind configuration and custom colors
  • components.json - Shadcn/UI configuration

πŸ“ Adding Content

New Project

Add a new project to the projects array in app/projects/page.tsx:

{
  id: 7,
  name: 'Project Name',
  description: 'Project description...',
  stars: 1234,
  forks: 89,
  watchers: 45,
  language: 'TypeScript',
  languageColor: 'bg-blue-500',
  category: 'Category',
  status: 'stable',
  lastUpdate: '2024-01-20',
  topics: ['topic1', 'topic2'],
  license: 'MIT',
}

New Research Paper

Add a new markdown file to the research-documents/ directory:

---
title: "Your Research Title"
authors: 
  - "Author Name"
date: "2024-01-20"
abstract: "Brief abstract..."
category: "AI/ML"
tags: ["machine-learning", "research"]
featured: true
status: "published"
---

# Your Research Content

Write your research paper in markdown format with full support for:
- Code syntax highlighting
- Mathematical equations (LaTeX)
- Tables and diagrams
- Automatic table of contents
- Citations and references

See research-documents/README.md for detailed documentation on writing research papers.

πŸš€ Deployment

Vercel (Recommended)

  1. Push your code to a Git repository (GitHub, GitLab, Bitbucket)
  2. Import your project on Vercel
  3. Configure environment variables if needed
  4. Deploy!

The website is optimized for Vercel with automatic deployments on push.

Other Platforms

The website exports as a static site and can be deployed to:

  • Netlify
  • GitHub Pages
  • AWS S3 + CloudFront
  • Any static hosting provider

Run the build command:

npm run build

The out directory contains the static files ready for deployment.

πŸ“Š Analytics

To add analytics, install your preferred solution:

Vercel Analytics

npm install @vercel/analytics

Plausible

npm install next-plausible

πŸ”§ Configuration

Environment Variables

Create a .env.local file for local development:

# GitHub API Token (Optional but recommended to avoid rate limiting)
# Create a personal access token at https://github.com/settings/tokens
# No special permissions needed for public repository access
GITHUB_TOKEN=your_github_token_here

# Site Configuration
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Note: The GitHub token is optional but highly recommended for the Hall of Fame page. Without it, the GitHub API has a rate limit of 60 requests/hour. With a token, you get 5000 requests/hour. You can create a token at https://github.com/settings/tokens - no special permissions are needed for accessing public repositories.

SEO Configuration

Update metadata in app/layout.tsx:

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

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

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

πŸ“„ License

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

πŸ™ Acknowledgments

πŸ“ž Support


TIVerse - Empowering developers with open-source tools that are performant, reliable, and built for the real world.

About

Showcasing our open-source ecosystem, projects, mission, and vision. Built with Next.js, TypeScript, Tailwind CSS, and Framer Motion.

Topics

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •