- AI-Powered Content Creation - Generate text, images, and multimedia content using Gemini AI
- Creative Writing Assistant - Professional document creation and creative storytelling
- Multi-format Export - Export content in various formats for different use cases
- Smart Timezone Management - Real-time timezone cards with live clock updates
- Time Conversion Tools - Seamless time conversion for global collaboration
- Email Reminder Scheduling - AI-powered reminder system with timezone awareness
- Contact Management - Intelligent contact organization with AI-enhanced search
- Document Analysis - Automated document processing and workflow integration
- Secure Authentication - Clerk integration for robust user management
- Protected Routes - Secure access to sensitive features
- Session Management - Persistent user sessions with automatic authentication flow
- Interactive Carousel - Engaging homepage with auto-play feature showcase
- Responsive Design - Mobile-first design that works across all devices
- Dark Theme UI - Modern interface with gradient accents and smooth animations
- Real-time Updates - Live data updates and instant feedback
- Next.js 15 - React framework with App Router for modern web development
- React 19 - Latest React features with concurrent rendering
- TypeScript - Type-safe development with enhanced developer experience
- Tailwind CSS - Utility-first CSS framework for rapid UI development
- Clerk - Complete authentication solution with user management
- Protected Routes - Secure access control for sensitive features
- Google Gemini API - Advanced AI capabilities for content generation and analysis
- @google/genai - Official Google Generative AI SDK
- Resend API - Reliable email delivery for notifications and reminders
- Lucide React - Beautiful, customizable icons
- Custom Components - Reusable UI components with consistent design
- ESLint - Code linting for consistent code quality
- PostCSS - CSS processing and optimization
- Node.js (v18 or higher)
- npm or yarn
- Gemini API Key from Google AI Studio
- Clerk Account for authentication
- Resend Account for email services
-
Clone the repository
git clone <repository-url> cd StormNotesV1
-
Install dependencies
npm install
-
Environment Configuration
Copy the example environment file:
cp .env.example .env.local
Configure your environment variables in
.env.local:# Gemini AI Configuration GEMINI_API_KEY=your_gemini_api_key_here # Clerk Authentication NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key CLERK_SECRET_KEY=your_clerk_secret_key # Resend Email Service (Optional) RESEND_API_KEY=your_resend_api_key
-
Run the development server
npm run dev
-
Open your browser
Navigate to http://localhost:3000 to see the application.
- Sign Up/Sign In - Create an account or sign in using the authentication buttons
- Explore Features - Use the "Get Started" button to access the module selection modal
- Choose Your Module:
- Content Generator - For AI-powered content creation
- Productivity Suite - For time management and workflow tools
- Navigate to the Productivity Suite
- Add timezone cards for locations you work with
- View real-time clocks and manage global schedules
- Access the Content Generator module
- Select your content type (text, image, etc.)
- Let Gemini AI assist with creation and refinement
- Go to the Reminders section in Productivity Suite
- Set your reminder message and recipient email
- Choose date/time (minimum 1 minute in future) and timezone
- AI calculates optimal delivery timing
StormNotesV1/
βββ app/ # Next.js App Router pages
βββ components/ # Reusable React components
β βββ HeroCarousel.tsx # Homepage carousel component
β βββ FeatureCards.tsx # Feature showcase cards
β βββ TopNavBar.tsx # Navigation with authentication
β βββ ...
βββ services/ # API service layers
β βββ geminiService.ts # Gemini AI integration
β βββ resendService.ts # Email service integration
β βββ apiService.ts # General API utilities
βββ hooks/ # Custom React hooks
βββ public/ # Static assets
βββ types.ts # TypeScript type definitions
βββ ...
npm run dev- Start development servernpm run build- Build for productionnpm run start- Start production servernpm run lint- Run ESLint for code quality
Storm Notes leverages Google's Gemini AI to provide intelligent assistance across all features, from content generation to time calculations and workflow optimization.
Built for global teams with timezone-aware features, real-time updates, and seamless communication tools.
Implements modern authentication patterns with Clerk, ensuring user data security and privacy protection.
Built with modern development practices, comprehensive TypeScript support, and maintainable architecture.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
For support and questions:
- Check the Issues page
- Review the Project Report for detailed documentation
- Contact the development team
