From 96342af0f2c1206be144764bf1857e402f2daad3 Mon Sep 17 00:00:00 2001 From: nimanns Date: Mon, 18 Nov 2024 20:17:27 -0500 Subject: [PATCH] Revert "update readme." This reverts commit 991cf2341517bb796da3c4cf69359413bd6f0e28. --- README.md | 53 ++++++++++++++++++++++++++++++++--------------------- 1 file changed, 32 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index b6ba6b76..fcb5fa71 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,44 @@ # Booking App -## About +This project is a booking management application built with Next.js. -This application is designed for reserving rooms at the 370J Media Commons Room. +## Getting Started -## Deployment +Follow these steps to run the application in your local environment. -We employ GitHub workflows for our deployment process. -Any merges into the main branch automatically trigger a deployment to the production Google App Script. -We employ GitHub workflows for our deployment process. Pushing or merging to different branches will automatically trigger different Google App Script deploys: -- `main` branch: triggers the DEVELOPMENT deploy, which serves from localhost and reads/writes the development calendars -- `staging` branch: triggers the STAGING deploy, which serves from the GAS project and reads/writes the development calendars -- `prod` branch: triggers the PRODUCTION deploy, which serves from the GAS project and reads/writes the **production** calendars -The `NODE_ENV` environment variable controls where we serve from, and the `CALENDAR_ENV` environment variable controls which calendars we use. These values are specified in the `package.json` commands triggered by the workflows +### Prerequisites -## Setup Instructions +- Node.js (version 18 or later) +- npm (usually comes with Node.js) -When developing locally, please follow the flow below. +### Installation -1. **Clone the Repository**: +1. Clone the repository or download the project files. -2. **Install Packages**: - ```bash - npm install +2. Navigate to the project directory: + ``` + cd booking-app ``` +3. Install the dependencies: + `npm install` +4. Obtain the `.env` file from a project administrator and place it in the root directory of the project. + +### Running the Application + +To start the development server: +`npm run dev` +The application should now be running on [http://localhost:3000](http://localhost:3000). + +## Environment Variables + +This project uses environment variables for configuration. Make sure you have received the `.env` file from a project administrator and placed it in the root directory before running the application. + +## Deployment + +This project uses automated deployment pipelines: -3. **Make sure that you have placed the `.env.local` file in the root directory** +- Pushing to the `main` branch automatically deploys to the development environment. +- Pushing to the `staging` branch automatically deploys to the staging environment. +- Pushing to the `production` branch automatically deploys to the production environment. -4. **Run the dev local server** - ```bash - npm run dev - ``` \ No newline at end of file +Please ensure you push your changes to the appropriate branch based on the intended deployment environment.