Week 1

Author: ManasMadan

.gitignore

@@ -0,0 +1,2 @@
+# misc
+.DS_Store

Govt-Billing-React/.browserslistrc

@@ -0,0 +1,6 @@
+Chrome >=79
+ChromeAndroid >=79
+Firefox >=70
+Edge >=79
+Safari >=14
+iOS >=14

Govt-Billing-React/.env.example

@@ -0,0 +1,7 @@
+VITE_FIREBASE_VITE_APP_TITLE="firebase app title"
+VITE_FIREBASE_API_KEY="firebase_key"
+VITE_FIREBASE_AUTH_DOMAIN="domain_name.firebaseapp.com"
+VITE_FIREBASE_PROJECT_ID="project_id"
+VITE_FIREBASE_STORAGE_BUCKET="storage_bucket"
+VITE_FIREBASE_MESSAGING_SENDER_ID="sender_id"
+VITE_FIREBASE_APP_ID="firebase_app_id"

Govt-Billing-React/.eslintrc.js

@@ -0,0 +1,17 @@
+module.exports = {
+  root: true,
+  env: {
+    node: true
+  },
+  'extends': [
+    'plugin:react/recommended',
+    'eslint:recommended'
+  ],
+  parserOptions: {
+    ecmaVersion: 2020
+  },
+  rules: {
+    'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
+    'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
+  }
+}

Govt-Billing-React/.gitignore

@@ -9,16 +9,22 @@
 /coverage
 
 # production
-/build
+/dist
 
 # misc
 .DS_Store
+.env
 .env.local
 .env.development.local
 .env.test.local
 .env.production.local
-.vscode
+/.vscode/*
+!/.vscode/extensions.json
+.idea
 
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+
+# Optional eslint cache
+.eslintcache

Govt-Billing-React/.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+    "recommendations": [
+        "ionic.ionic"
+    ]
+}

Govt-Billing-React/LICENSE

@@ -1,6 +1,101 @@
-1. npm i -g @ionic/cli
-2. git clone https://github.com/geetanshu2502/ionicReactApp
-3. cd ionicReactApp
-4. npm install
-5. ionic serve (With tis you can access the app in browser)
-6. ionic capacitor open android(opens android studio with the application, build and run)
+# Project Migration and Fixes
+
+This project involves the migration of an Ionic v5 app with outdated dependencies to Ionic v7 using Vite as the build tool. The process included transferring code and addressing various issues encountered during the migration.
+
+## Migration Steps
+
+- Create a new Ionic Vite app:
+
+```bash
+npx create-ionic-vite@latest
+```
+
+- Transfer code from the original Ionic v5 project to the new Vite-based project.
+
+- Fix errors encountered during the migration process by addressing them one by one.
+
+## Integration of SocialCalc
+
+During the integration of SocialCalc, an issue arose when switching from UMD to ES6 imports. Although the code worked on the web, it failed on an Android emulator due to the unavailability of the window object.
+
+To resolve this, the UMD module was re-implemented, and the window object was defined in the SocialCalc file. Additionally, the SocialCalc file's outdated code lacked variable declarations. To make these variables available at the top of the scope, the var keyword was used.
+
+## Android Emulator Compatibility Fix
+
+To make the project compatible with an Android emulator, ensure that variables are declared at the top of the scope in the SocialCalc file. This step is essential for addressing issues related to the unavailability of the window object on the Android platform.
+
+## Running the Project on Web
+
+To build an APK from the codebase, follow these steps:
+
+- Install Node.js if not already installed.
+
+- Clone the repository:
+
+```bash
+git clone REPO_URL
+```
+
+- Navigate to the project directory:
+
+```bash
+cd REPO_NAME
+```
+
+- Install project dependencies:
+
+```bash
+npm install
+```
+
+- Install the Ionic CLI globally:
+
+```bash
+npm install -g @ionic/cli
+```
+
+- Setup a firebase project and add the firebase configuration in the `.env` file in the format given in the `.env.example`
+
+- Serve the application:
+
+```bash
+ionic serve
+```
+
+These steps will set up the project and allow you to test it in a development environment.
+
+## Running the Project on Android Device
+
+- Install Android Studio if not already installed.
+
+- Sync android codebase
+
+```bash
+ionic cap sync android
+```
+
+- Opening the Project in android Studio
+
+```bash
+ionic cap open android
+```
+
+Now you can run the app on a physical device or a virtual emulator, you can also build the app from the menu bar
+
+## Running the Project on IOS Device
+
+- Install XCode and XCode CLI if not already installed.
+
+- Sync ios codebase
+
+```bash
+ionic cap sync ios
+```
+
+- Opening the Project in XCode
+
+```bash
+ionic cap open ios
+```
+
+Now you can run the app on a physical device or a virtual emulator, you can also build the app from the menu bar

Govt-Billing-React/README.md

@@ -1,11 +1,8 @@
-# NPM renames .gitignore to .npmignore
-# In order to prevent that, we remove the initial "."
-# And the CLI then renames it
-
-# Using Android gitignore template: https://github.com/github/gitignore/blob/master/Android.gitignore
+# Using Android gitignore template: https://github.com/github/gitignore/blob/HEAD/Android.gitignore
 
 # Built application files
 *.apk
+*.aar
 *.ap_
 *.aab
 
@@ -19,7 +16,8 @@
 bin/
 gen/
 out/
-release/
+#  Uncomment the following line in case you need and you don't have the release build type files in your app
+# release/
 
 # Gradle files
 .gradle/
@@ -61,6 +59,10 @@ captures/
 
 # External native build folder generated in Android Studio 2.2 and later
 .externalNativeBuild
+.cxx/
+
+# Google Services (e.g. APIs or Firebase)
+# google-services.json
 
 # Freeline
 freeline.py
@@ -84,8 +86,16 @@ lint/outputs/
 lint/tmp/
 # lint/reports/
 
+# Android Profiling
+*.hprof
+
 # Cordova plugins for Capacitor
 capacitor-cordova-android-plugins
 
 # Copied web assets
 app/src/main/assets/public
+
+# Generated Config files
+app/src/main/assets/capacitor.config.json
+app/src/main/assets/capacitor.plugins.json
+app/src/main/res/xml/config.xml