1️⃣ Local Deployment

To get the TechTonic app running locally on your machine for development or testing, follow these steps to clone the repositories, install dependencies, configure environment variables, and start the

Backend Setup

1. Clone the backend repository

bashCopyEditgit clone https://github.com/your-org/techtonic-backend.git
cd techtonic-backend

1. Install dependencies

bashCopyEditnpm install

1. Configure environment variables

Copy the example environment file and update it with your database credentials, API keys, and other secrets.

bashCopyEditcp .env.example .env
nano .env

Fill in variables like DB_URI, JWT_SECRET, CLOUDINARY_API_KEY, etc.

1. Start the backend server

bashCopyEditnpm run dev

The server will run on http://localhost:3000 by default.

---

Frontend Setup (Flutter)

1. Clone the frontend repository

bashCopyEditgit clone https://github.com/your-org/techtonic-frontend.git
cd techtonic-frontend

1. Install Flutter dependencies

bashCopyEditflutter pub get

1. Configure environment

Create or update environment config files if any (e.g., .env, or Flutter .dart config files).

1. Run the Flutter app

For Android:

bashCopyEditflutter run

For web:

bashCopyEditflutter run -d chrome

Make sure your backend server is running so the frontend can connect.

---

Troubleshooting

• Common issues:

  • Backend fails to start: check .env variables and MongoDB connection

  • Flutter app shows API errors: verify backend URL and network connectivity

  • Port conflicts: change ports in .env or Flutter config if needed

• Useful commands:

bashCopyEdit# Restart backend server after code changes
npm run dev

# Clean Flutter build cache if facing build issues
flutter clean
flutter pub get