Skip to content

README.md

Latest commit

 

History

History
124 lines (87 loc) · 3.45 KB

README.md

File metadata and controls

124 lines (87 loc) · 3.45 KB

MeetApp

A end of term project assignment MeetApp

💻 Created With

Frontend & Backend

  • Framework : React.js
  • Language : JavaScript,Html,Css
  • Styling : MaterialUI
  • Components : React Component & Redux & React Router
  • Package Manager : npm

API

  • Application : .NET
  • Framework : EFCore
  • Language : C#
  • Database : MSSQL

📁 Project Structure

MeetApp/          
├── MeetAppApi/    
│   └── Context/ 
│   └── .gitignore
├── MeetAppWeb/     
│   └── src/
│   └── .gitignore   
├── README.md
└── LICENSE

🚀 MeetApp – Installation & Setup

🔹 Frontend (React + Vite)

  1. Clone the repository (or download the source code):

    git clone https://github.com/EEnsarA/MeetApp
cd MeetApp

  2. Install dependencies:

    npm install

  3. Set up your environment variables:

    Create a .env file in the root of your project:

    VITE_API_URL=http://localhost:5134

    Replace http://localhost:5134 with the actual address of your MeetApp API if different.

  4. Run the development server:

    npm run dev

  5. Open your browser:

    Visit http://localhost:5173 to view the application.

    💡 Note: If port 5173 is already in use, Vite will automatically pick another available port (e.g. 5174). Check your terminal output to confirm the correct URL.


🔹 Backend (ASP.NET Core API)

  1. Navigate to the API project folder (e.g., MeetAppApi) and open the solution in your IDE.

  2. Configure environment settings:

Open or create the appsettings.Development.json file and update the following values:

    {
    "ConnectionStrings": {
        "sql_connection": "Data Source=localhost;Initial Catalog=MeetApp;Integrated Security=True;Encrypt=True;Trust Server Certificate=True;"
    },
    "AppSettings": {
        "secretKey": "your-development-secret-key"
    }
    }

⚠️ Do not share your real connection string or secret key publicly!

  1. 🗃️ Database Setup

This project includes the required Entity Framework Core migrations.

To create and update your local SQL Server database, run the following command inside the MeetAppApi project directory:

    dotnet ef database update

This will apply the existing migrations and create the necessary tables.

⚠️ Make sure your connection string is properly configured in appsettings.Development.json before running this command.

  1. Run the API project:

Use Visual Studio, Rider, or the .NET CLI:

    dotnet watch

The API will typically run at https://localhost:5134, depending on your launch settings.

✅ Final Notes

  • Make sure both the API and frontend are running.

  • The frontend expects the API to be reachable at the address defined in VITE_API_URL.

  • If you face CORS issues, ensure your ASP.NET Core backend is properly configured to allow requests from the frontend origin.

📃 License

License: MIT

This project is licensed under the MIT License. See the LICENSE file for details.