refactor: updated readme

Co-authored-by: Sebastian Palmqvist <PalmN72@users.noreply.github.com>
This commit is contained in:
Lee 2023-11-03 13:35:36 +01:00
parent b44977b150
commit 30573db606
3 changed files with 35 additions and 166 deletions

View File

@ -22,7 +22,6 @@ The respective README files there contain more detailed descriptions.
* [Architecture](#architecture)
* [Apps](#apps)
* [skolplattformen](#skolplattformen)
* [skolplattformen dependency upgrade](#skolplattformen-dependency-upgrade)
* [website](#website)
* [Libs](#embedded-api)
* [api](#api)
@ -59,9 +58,6 @@ We're starting small, with more features being added over time.
For more information, check out the [source code](apps/skolplattformen-app).
#### skolplattformen dependency upgrade
A dependency upgrade is currently in the works. To navigate directly to the related readme, click [here](/apps/skolplattformen-app-new/README-NEW.md).
#### website
The code for the website at https://skolplattformen.org/. It's built using Next.js.

View File

@ -1,102 +0,0 @@
# Skolplattformen React Native Project
Welcome to this new [**React Native**](https://reactnative.dev) project, initiated using [`@react-native-community/cli`](https://github.com/react-native-community/cli).
## Pre-requisites
> **Important**: Make sure you have gone through the [React Native - Environment Setup](https://reactnative.dev/docs/environment-setup) guide up to the "Creating a new application" step before moving forward.
## Initial Setup
### Required Software
1. [Git](https://git-scm.com/)
2. [Node](https://nodejs.org/en/)
3. [NPM](https://docs.npmjs.com/cli/v8/commands/npm-install)
### Minimum Node Version
Ensure you are using Node version 16 or higher.
### Cloning the Repository
```bash
git clone https://github.com/Home-Biz-LLS/skolplattformen-react-native
```
### Installing Dependencies
```bash
cd apps/skolplattformen-app-new/ && npm i
```
---
## Running the App
### For iOS
**Note**: Running the iOS app requires a Mac with native support. Windows/Linux are currently not supported.
#### Essential Guides and Tools
* [Mac OS Setup Guide](https://reactnative.dev/docs/environment-setup)
#### Step-by-Step Instructions
1. **Install Xcode**: Ensure Xcode is installed on your system.
2. **Install CocoaPods**: If not already installed, you can do this easily using Homebrew.
- [Homebrew Install Guide for CocoaPods](https://formulae.brew.sh/formula/cocoapods)
- [Official CocoaPods Guide](https://guides.cocoapods.org/using/getting-started.html)
3. **Install Pods**
```bash
cd apps/skolplattformen-app-new/ios && pod install
```
#### Running the iOS App
* Option 1: Using Metro Bundler
![metro bundler example](/apps/skolplattformen-app-new/docs/assets/MetroBundlerExample.png)
```bash
cd apps/skolplattformen-app-new && npm run start
```
then type
```bash
i
```
* Option 2: Running Directly
```bash
npm run ios
```
---
### For Android
**Note**: Choose an appropriate guide based on your operating system:
* [Mac OS](/apps/skolplattformen-app-new/docs/android_mac.md)
* [Windows](/apps/skolplattformen-app-new//docs/android_windows.md)
* [Linux](/apps/skolplattformen-app-new//docs/android_linux.md)
#### Running the Android App
* Option 1: Using Metro Bundler
![metro bundler example](/apps/skolplattformen-app-new/docs/assets/MetroBundlerExample.png)
```bash
cd apps/skolplattformen-app-new && npm run start
```
then type
```bash
a
```
* Option 2: Running Directly
```bash
npm run android
```

View File

@ -1,84 +1,59 @@
This is a new [**React Native**](https://reactnative.dev) project, bootstrapped using [`@react-native-community/cli`](https://github.com/react-native-community/cli).
# Öppna skolplattformen App
# Getting Started
This is the app for Öppna skolplattformen.
>**Note**: Make sure you have completed the [React Native - Environment Setup](https://reactnative.dev/docs/environment-setup) instructions till "Creating a new application" step, before proceeding.
## Getting started
## Getting started with Development
Have a look at the [overall readme](../../) for general instructions on getting started.
### Please use node version 16 or higher
### Prerequisites
To clone and build the project, you first need to install [git](https://git-scm.com/), [node](https://nodejs.org/en/) and [npm](https://docs.npmjs.com/cli/v8/commands/npm-install).
Clone the repo with
```bash
$ git clone https://github.com/Home-Biz-LLS/skolplattformen-react-native
```
Install dependencies
```bash
cd apps/skolplattformen-app-new/ && npm i
```
We use `yarn` as our package manager. To install it, run `sudo npm install -g yarn`. All the commands described here should be run from the `packages/app` directory.
### iOS
If you wanna run the iOS app, you need to setup a couple of things first, we have a guide that will assist you in getting started with the iOS app. A Mac is required to build projects with native code for iOS so we do not have support for Linux / Windows.
To get started using the iOS simulator start by installing the JavaScript
dependencies using
* [Mac OS](https://reactnative.dev/docs/environment-setup)
#### Step 1
Make sure you have **Xcode** installed
#### Step 2
Make sure **CocoaPods** is installed (you can do it easily with homebrew)
* [CocoaPods homebrew](https://formulae.brew.sh/formula/cocoapods)
* [CocoaPods](https://guides.cocoapods.org/using/getting-started.html)
#### Step 3
```bash
cd apps/skolplattformen-app-new/ios && pod install
$ yarn
```
If you already setup everything, go into the
Next you need to install the [Cocoapods](https://cocoapods.org/) dependencies
for the iOS project
"skolplattformen-app-new" directory
Start the metro
```
npm run start
```bash
$ cd ios
$ pod setup
$ pod install
```
then
You should now be setup to run the app in the Simulator. Run the `ios` command
in the root of the app.
```bash
$ yarn ios
```
i
```
to Start iOS app
OR
Start the iOS app directly
```
npm run ios
```
### Android
If you wanna run the Android app, you need to setup a couple of things first, we have created three different guides depending on your operating system.
Android development requires that you have [Android Studio](https://developer.android.com/studio) and relevant build tools installed.
* [Mac OS](/docs/android_mac.md)
* [Windows](/docs/android_windows.md)
* [Linux](/docs/android_linux.md)
Start by installing JavaScript dependencies using
If you already setup everything, you just need to run the following command in the project root:
```
yarn run android
```bash
$ yarn
```
Before running the app you should start an emulator from Android Studio. Then
run the following command to start the build
```bash
$ yarn android
```
## Running tests
```bash
$ yarn test
```