Skip to content

Laungify/Tascade

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

🌟 Task Manager

📝 Overview

This project is a web application where users can create and manage projects. It involves a backend built with Express.js, a frontend built with React, and Xata as the database solution. This README will guide you through setting up and running the project from scratch.

📑 Table of Contents

  1. Prerequisites
  2. Project Setup
  3. Running the Project
  4. API Documentation
  5. Environment Variables
  6. Technologies Used
  7. Contributing

🔧 Prerequisites

Before you begin, ensure you have the following installed:


⚙️ Project Setup

🔙 Backend (Express)

  1. Clone the repository:
    git clone <your-repo-url> 📦
    cd <your-project-directory> 🗂️
  2. Install all dependencies:
    Copy code
    pnpm install   # or npm install
    Set up environment variables: In the root of the project directory, create a .env file and add the following:
    
    bash
    Copy code
    PORT=5000
    DATABASE_URL=<your-xata-database-url>
    Run the backend server:
    
    bash
    Copy code
    pnpm run dev   # or npm run dev
    The backend server will start at http://localhost:5000.
    
  3. 💽 Database (Xata):
     Install the Xata CLI:
    
     bash
     Copy code
     pnpm add -g @xata.io/cli   # or npm install -g @xata.io/cli
     Login to Xata:
     
     bash
     Copy code
     xata auth login
     Set up your database:
     
     bash
     Copy code
     xata init
     Push your schema to Xata:
     
     bash
     Copy code
     xata push
  4. 🖥️ Frontend (React):
     Navigate to the frontend directory:
    
     bash
     Copy code
     cd ../frontend
     Install frontend dependencies:
     
     bash
     Copy code
     pnpm install   # or npm install
     Set up environment variables: In the frontend directory, create a .env file and add your backend URL:
     
     bash
     Copy code
     REACT_APP_BACKEND_URL=http://localhost:5000
     Run the React app:
     
     bash
     Copy code
     pnpm run start   # or npm run start
     This will start the React app on http://localhost:3000.
    
  5. 🏃 Running the Project:
     Start the Backend: Navigate to the backend folder and run:
     
     bash
     Copy code
     pnpm run dev   # or npm run dev
     Start the Frontend: Navigate to the frontend folder and run:
     
     bash
     Copy code
     pnpm run start   # or npm run start
     Now both the frontend and backend should be running, and you can access the application at http://localhost:3000.
    
  6. 📖 API Documentation:
     POST /api/v1/project: Create a new project
     GET /api/v1/project: Retrieve all projects
     PATCH /api/v1/project/:id: Update a project
     DELETE /api/v1/project/:id: Delete a project
    
        POST /api/v1/teams: Create a new project
     GET /api/v1/teams: Retrieve all projects
     PATCH /api/v1/teams/:id: Update a project
     DELETE /api/v1/teams/:id: Delete a project
    
        POST /api/v1/task: Create a new project
     GET /api/v1/task: Retrieve all projects
     PATCH /api/v1/task/:id: Update a project
     DELETE /api/v1/project/:id: Delete a project
    
        POST /api/v1/comments: Create a new project
     GET /api/v1/comments: Retrieve all projects
     PATCH /api/v1/comments/:id: Update a project
     DELETE /api/v1/comments/:id: Delete a project
    
  7. 🌐 Environment Variables:
      PORT: The port on which the backend server will run (default: 5000).
      DATABASE_URL: Your Xata database connection URL.
      REACT_APP_BACKEND_URL: The URL of your backend server for the frontend app to communicate with.

🛠️ Technologies Used

    Backend: Express.js
    Frontend: React.js
    Database: Xata
    Package Manager: pnpm (or npm)

🤝 Contributing Contributions are welcome! Feel free to open a Pull Request or create an issue if you find any bugs or have suggestions for improvements.

Fork the project Create your feature branch (git checkout -b feature/your-feature-name) Commit your changes (git commit -am 'Add some feature') Push to the branch (git push origin feature/your-feature-name) Open a Pull Request

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors