meetfy 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,158 +1,43 @@
1
- # Meetfy CLI
1
+ <div align="center">
2
+ <h1>📆 meetfy</h1>
3
+ <h4>A CLI tool for creating instant meetings and reserving time in Google Calendar.</h4>
2
4
 
3
- A command-line tool for creating instant meetings and reserving 30 minutes in Google Calendar.
5
+ ![npm](https://img.shields.io/npm/v/meetfy) ![npm package minimized gzipped size (select exports)](https://img.shields.io/bundlejs/size/meetfy?color=green-light) ![npm](https://img.shields.io/npm/dw/meetfy)
4
6
 
5
- ## Features
6
-
7
- - 🚀 Create instant meetings with Google Meet
8
- - 📅 Automatically reserve 30 minutes in your Google Calendar
9
- - 👥 Add participants via email
10
- - 🔐 Secure Google OAuth2 authentication
11
- - 💾 Persistent authentication tokens
12
- - 🎨 Beautiful CLI interface with colors and spinners
13
-
14
- ## Installation
15
-
16
- 1. Clone the repository:
17
- ```bash
18
- git clone <repository-url>
19
- cd meetfy
20
- ```
21
-
22
- 2. Install dependencies:
23
- ```bash
24
- npm install
25
- ```
26
-
27
- 3. Build the project:
28
- ```bash
29
- npm run build
30
- ```
7
+ </div>
31
8
 
32
- 4. Link globally (optional):
33
- ```bash
34
- npm link
35
- ```
36
-
37
- ## Setup
38
-
39
- ### 1. Google Calendar API Setup
40
-
41
- 1. Go to [Google Cloud Console](https://console.cloud.google.com)
42
- 2. Create a new project or select an existing one
43
- 3. Enable the Google Calendar API:
44
- - Go to "APIs & Services" → "Library"
45
- - Search for "Google Calendar API"
46
- - Click "Enable"
47
- 4. Create OAuth 2.0 credentials:
48
- - Go to "APIs & Services" → "Credentials"
49
- - Click "Create Credentials" → "OAuth 2.0 Client IDs"
50
- - Choose "Desktop application"
51
- - Download the credentials file
52
- 5. Rename the downloaded file to `credentials.json` and place it in the project root
53
-
54
- The `credentials.json` file should look like this:
55
- ```json
56
- {
57
- "installed": {
58
- "client_id": "your-client-id.apps.googleusercontent.com",
59
- "project_id": "your-project-id",
60
- "auth_uri": "https://accounts.google.com/o/oauth2/auth",
61
- "token_uri": "https://oauth2.googleapis.com/token",
62
- "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
63
- "client_secret": "your-client-secret",
64
- "redirect_uris": ["http://localhost"]
65
- }
66
- }
67
- ```
68
-
69
- ### 2. Authentication
70
-
71
- Run the authentication command:
72
- ```bash
73
- npm run dev auth
74
- # or if linked globally:
75
- meetfy auth
76
- ```
77
9
 
78
- Follow the authentication flow to authorize the application.
79
-
80
- ## Usage
10
+ ## Features
11
+ - 🎯 Create instant meetings and reserve time in Google Calendar.
12
+ - 📝 Add participants to the meeting.
13
+ - 🕒 Choose the duration of the meeting.
81
14
 
82
- ### Create an Instant Meeting
83
15
 
84
- Basic usage:
85
- ```bash
86
- npm run dev create
87
- # or if linked globally:
88
- meetfy create
89
- ```
16
+ ## Install
90
17
 
91
- With options:
92
- ```bash
93
- meetfy create -t "Team Standup" -d "Daily team sync" -p "john@example.com,jane@example.com"
18
+ ```sh
19
+ npm i -g meetfy
94
20
  ```
95
21
 
96
- ### Available Options
97
-
98
- - `-t, --title <title>`: Meeting title
99
- - `-d, --description <description>`: Meeting description
100
- - `-p, --participants <emails>`: Comma-separated list of participant emails
101
-
102
- ### Authentication
22
+ ## Quickstart
103
23
 
104
- To authenticate or re-authenticate:
105
- ```bash
106
- meetfy auth
24
+ ```sh
25
+ npm i -g meetfy
26
+ meetfy auth # authenticate with Google Calendar
27
+ meetfy create # create a new meeting
28
+ meetfy next # show your next meeting
29
+ meetfy logout # log out
107
30
  ```
108
31
 
109
- ## Development
32
+ Use `--json` for machine-readable output (e.g. `meetfy --json next`).
110
33
 
111
- ### Run in Development Mode
112
- ```bash
113
- npm run dev
114
- ```
115
-
116
- ### Build for Production
117
- ```bash
118
- npm run build
119
- ```
34
+ ## Publishing (maintainers)
120
35
 
121
- ### Run Built Version
122
- ```bash
123
- npm start
36
+ ```sh
37
+ pnpm run build # build dist/index.js
38
+ npm publish # runs prepublishOnly (build) then publishes
124
39
  ```
125
40
 
126
- ## Project Structure
127
-
128
- ```
129
- src/
130
- ├── features/
131
- │ ├── auth/
132
- │ │ └── authService.ts # Google OAuth2 authentication
133
- │ └── meeting/
134
- │ └── meetingService.ts # Meeting creation and calendar integration
135
- ├── utils/
136
- │ └── cliUtils.ts # CLI utilities and formatting
137
- └── index.ts # Main CLI entry point
138
- ```
139
-
140
- ## Features
141
-
142
- - **Instant Meeting Creation**: Creates meetings that start in 5 minutes
143
- - **30-Minute Duration**: Automatically sets 30-minute duration
144
- - **Google Meet Integration**: Includes Google Meet link in calendar events
145
- - **Participant Management**: Add participants via email addresses
146
- - **Calendar Reminders**: Sets up email and popup reminders
147
- - **Persistent Authentication**: Saves and reuses authentication tokens
148
- - **Interactive CLI**: User-friendly prompts and colorful output
149
-
150
- ## Requirements
151
-
152
- - Node.js 18+
153
- - Google Calendar API access
154
- - Google OAuth2 credentials
155
-
156
41
  ## License
157
42
 
158
- ISC
43
+ MIT © [@eduardoborges](https://github.com/eduardoborges)