https://github.com/getange/my-calender
This repository contains a google-calender replica
https://github.com/getange/my-calender
Last synced: about 1 year ago
JSON representation
This repository contains a google-calender replica
- Host: GitHub
- URL: https://github.com/getange/my-calender
- Owner: GETANGE
- Created: 2024-10-30T18:20:44.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-01-26T21:35:16.000Z (over 1 year ago)
- Last Synced: 2025-06-01T16:28:28.594Z (about 1 year ago)
- Language: TypeScript
- Homepage:
- Size: 407 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📅 Calendery Web App
Calendery is a modern, user-friendly web application designed to help you manage your schedules, appointments, and events efficiently. Whether you need to track personal tasks, team meetings, or project deadlines, Calendery has you covered with an intuitive interface and powerful features.
---
## ✨ Features
- **📆 Event Scheduling**: Create, update, and delete events with ease.
- **🗓️ Daily, Weekly, Monthly Views**: View your calendar in different layouts for better clarity.
- **⏰ Notifications and Reminders**: Stay on top of your tasks with timely alerts.
- **🤝 Collaborative Scheduling**: Share your calendar and invite others to events.
- **📱 Responsive Design**: Access your calendar seamlessly across devices (desktop, tablet, and mobile).
- **🎨 Customization Options**: Personalize your calendar with themes, colors, and more.
- **🔒 Secure Data Management**: Your schedule is stored securely and is accessible only to you.
---
## 🛠️ Technologies Used
- **Frontend**: React.js, HTML5, CSS3, JavaScript
- **Backend**: Node.js, Express.js
- **Database**: PostgreSQL
- **Authentication**: JWT (JSON Web Tokens) for secure login and user management
- **State Management**: Tansack Query
- **API Integration**: RESTful APIs for event management and notifications
---
## 🚀 Installation
Follow these steps to set up Calendery locally on your machine:
### Prerequisites
- 🟢 Node.js (v16 or higher)
- 📦 npm or yarn
- 🗄️ PostgreSQL (local or cloud instance)
### Setup
1. **📂 Clone the repository:**
```bash
git clone https://github.com/Getange/calendery.git
```
2. **📁 Navigate to the project directory:**
```bash
cd calendery
```
3. **📥 Install dependencies:**
```bash
npm install
# or
yarn install
```
4. **⚙️ Configure environment variables:**
- Create a `.env` file in the root directory.
- Add the following:
```env
PORT=5000
DATABASE_URI=your-postgres-uri
JWT_SECRET=your-secret-key
```
5. **▶️ Run the application:**
```bash
npm start
# or
yarn start
```
6. **🌐 Access the app:**
Open your browser and go to `http://localhost:5173`.
---
## 🧑💻 Usage
1. **🔐 Sign up or log in:** Create an account to get started.
2. **➕ Add events:** Click the "Add Event" button and fill in the details.
3. **🔄 Manage your calendar:** Drag and drop events to reschedule, or click to edit.
4. **📤 Share with others:** Invite collaborators by sharing event links.
---
## 🤝 Contributing
We welcome contributions to Calendery! To get started:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature-name
```
3. Commit your changes:
```bash
git commit -m "Add new feature"
```
4. Push to your branch:
```bash
git push origin feature-name
```
5. Submit a pull request.
---
## 📜 License
This project is licensed under the MIT License. See the `LICENSE` file for details.
---
## 📧 Contact
For questions, suggestions, or support, please contact:
- **Name**: Emmanuel Getange
- **Email**: [emmanuelgetange48@gmail.com](mailto:your-email@example.com)
- **GitHub**: [https://github.com/Getange](https://github.com/your-username)
---
Thank you for using Calendery! Manage your time effectively and stay organized. 🎉