Skip to content
noluyorAbiPublic

About

AiCal – AI-powered web app that turns natural language into Google Calendar entries and .ics files. Modern, intuitive, and premium dark UI built with Next.js, TypeScript, and TailwindCSS.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

forthebadge forthebadge

Next JS React TypeScript TailwindCSS Threejs Framer

AiCal

Transform messages into calendar events — effortlessly.

AiCal is an intelligent web application that uses Google's Gemini AI to automatically extract event information from any text message or email and generate ready-to-use calendar entries for Google Calendar, Outlook, and downloadable ICS files.

Try it live →


Features

AI-Powered Event Extraction

  • Automatically extracts event titles, descriptions, locations, and times from natural language
  • Handles multiple events from a single input
  • Intelligent date and time parsing (e.g., "tomorrow at 3pm", "next Tuesday")
  • Comprehensive context understanding

Universal Calendar Support

  • Google Calendar Links - One-click add to Google Calendar
  • Microsoft Outlook Links - Seamless Outlook integration
  • ICS File Downloads - Compatible with any calendar application
  • Multi-Event Support - Extract and create multiple events simultaneously

Modern, Animating UI

  • Sleek dark theme with gradient accents
  • Smooth animations powered by Framer Motion
  • Glassmorphism effects and modern design
  • Fully responsive and accessible
  • Interactive magnetic buttons and spotlight cards

Privacy-First

  • No data storage - your messages are processed and discarded immediately
  • Secure AI processing via Google's API
  • No tracking or monitoring
  • Client-side event generation

Tech Stack

Core Technologies

Additional Libraries

  • ics - Generate ICS calendar files
  • lucide-react - Beautiful icons
  • react-icons - Additional icon sets
  • class-variance-authority - Component variants
  • three - 3D animations

Getting Started

Prerequisites

  • Node.js 18+ or Bun 1.0+
  • Google AI Studio API Key (Get one here)

Installation

  1. Clone the repository
git clone https://github.com/noluyorAbi/aical.git
cd aical
  1. Install dependencies
npm install
# or
bun install
  1. Set up environment variables Create a .env.local file in the root directory:
GOOGLE_API_KEY=your-google-api-key-here
  1. Run the development server
npm run dev
# or
bun dev
  1. Open your browser Navigate to http://localhost:3000

How It Works

1. Paste Message Content

Simply paste any message, email, or text containing event information. Examples:

  • Meeting invitations
  • Event announcements
  • Appointment reminders
  • RSVP messages

2. AI Processing

The application uses Google's Gemini AI to intelligently extract:

  • Event title
  • Description (comprehensive context preserved)
  • Location (with automatic detection)
  • Start date & time
  • End date & time

3. Instant Calendar Generation

Get ready-to-use links and files:

  • Google Calendar one-click add link
  • Outlook Calendar integration link
  • Downloadable .ics file for any calendar app

Use Cases

Professional

  • Convert meeting invitations into calendar events
  • Extract conference details from announcements
  • Schedule team events from Slack/email threads

Personal

  • Add event details from party invitations
  • Schedule appointments from reminders
  • Organize social events from group chats

Email Workflow

  • Convert Outlook invitations to Google Calendar
  • Sync events across multiple calendars
  • Import events from email templates

Configuration

API Configuration

The application uses Google's Gemini API for AI processing. Configure your API key in the environment:

GOOGLE_API_KEY=your-key-here

Customization

  • Styling: Edit app/globals.css or use Tailwind classes
  • AI Prompt: Modify the prompt in app/api/event/route.ts
  • Components: Customize UI components in components/
  • Animations: Adjust Framer Motion animations in UI components

Project Structure

ai-calender-events/
├── app/
│   ├── api/
│   │   └── event/
│   │       └── route.ts          # API endpoint for AI processing
│   ├── page.tsx                  # Main landing page
│   ├── layout.tsx                # Root layout
│   └── globals.css               # Global styles
├── components/
│   ├── EventForm.tsx             # Main event extraction form
│   └── ui/                       # Reusable UI components
│       ├── react-bits.tsx        # Custom animated components
│       ├── AnimatedText.tsx
│       ├── SplitText.tsx
│       └── FadeText.tsx
├── tailwind.config.ts            # Tailwind configuration
├── tsconfig.json                 # TypeScript configuration
└── package.json                   # Dependencies

Contributing

Contributions are welcome! 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 'feat: Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Contributing Guidelines

  • Follow conventional commit messages
  • Write clear, commented code
  • Test your changes thoroughly
  • Update documentation as needed

License

This project is open source and available under the MIT License.


Author

Alperen Adatepe


Show Your Support

If you find this project useful, please give it a star on GitHub!

GitHub Stars


Built with Next.js, React, TypeScript, and Google Gemini AI

About

AiCal – AI-powered web app that turns natural language into Google Calendar entries and .ics files. Modern, intuitive, and premium dark UI built with Next.js, TypeScript, and TailwindCSS.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages