Tisane

Tisane is the official website for the AGH IT Future Day event. It is built with modern web technologies to provide a fast, responsive, and visually appealing experience.

The project is currently in active development, with plans to evolve into a fully custom Content Management System (CMS) to manage event content dynamically.

🚀 Tech Stack

• Framework: Next.js 16 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS v4
• UI Components: Radix UI, Lucide React
• Animations: GSAP, tw-animate-css
• Database (Planned): PostgreSQL with Drizzle ORM

✨ Features

• Modern Landing Page: A high-performance, responsive landing page for the event.
• Component-Based Architecture: Modular design using React Server Components.
• Interactive Animations: Smooth transitions and effects using GSAP.
• Dark/Light Mode: Built-in theme support.

🔮 Future Plans: Custom CMS

We are building a bespoke CMS to manage the site's content. This will allow for:

• Dynamic Page Building: A block-based editor for creating custom layouts.
• Role-Based Access Control: Secure admin dashboard for editors and admins.
• Media Management: Centralized library for images and assets.
• Theming Engine: No-code customization of site colors and fonts.

See roadmap.md for the detailed development plan.

🛠️ Getting Started

Prerequisites

• Node.js (v18 or later recommended)
• npm, yarn, pnpm, or bun

Installation

1. Clone the repository:

   git clone https://github.com/dkomeza/tisane.git
   cd tisane

2. Install dependencies:

   npm install

Running Locally

Start the development server:

npm run dev

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

Building for Production

To create a production build:

npm run build
npm start

📂 Project Structure

• app/: Next.js App Router pages and layouts.
• app/sections/: Modular components for the landing page sections.
• components/: Reusable UI components (buttons, inputs, etc.).
• scripts/: Utility scripts, including the roadmap_manager.py for syncing the roadmap with GitHub Issues.
• public/: Static assets.

Adding new CMS Components

To add a new CMS component, use the provided Handlebars template located at templates/CMSComponent.hbs. This template ensures that all necessary parts of the component (client, admin, preview) are created consistently.

npm run generate

This command will prompt you for the component name, category and generate the required files in the appropriate directories. It will also update the component registry automatically.