Skip to content

README.md

Latest commit

 

History

History
116 lines (84 loc) · 2.3 KB

README.md

File metadata and controls

116 lines (84 loc) · 2.3 KB
Raw

Forge Careers Client

The Forge Careers client is a mobile-first career exploration app that helps high school students learn about skilled-trades careers through interactive content, guided pathways, and simulation-style experiences.

It is built with React Native and Expo, with support for Android, iOS, and web.

Overview

Forge Careers is designed to make skilled-trades career exploration more engaging and easier to understand for students.

The client application provides the interface where users can explore careers, move through guided experiences, view interactive content, and access platform features.

Key Features

  • Mobile-first experience for Android and iOS
  • Web support through Expo
  • File-based navigation with Expo Router
  • Interactive screens and guided career exploration flows
  • Animated UI elements using Lottie and Moti
  • Secure authentication support with Clerk
  • API communication with Axios
  • Server-state handling with TanStack Query
  • Local storage and secure storage support
  • Mock API development using JSON Server

Tech Stack

Core

  • React Native
  • React
  • Expo
  • Expo Router
  • TypeScript

Navigation and UI

  • Expo Router
  • React Navigation
  • NativeWind
  • Tailwind CSS
  • Lottie
  • Moti
  • React Native Reanimated
  • React Native SVG

Data and Authentication

  • Axios
  • TanStack Query
  • Clerk Expo
  • AsyncStorage
  • Expo Secure Store
  • JSON Server for mock API data

Local Setup

git clone https://github.com/Forge-IDSP/client.git
cd client
npm install

Run the App

Start the Expo development server:

npm start

Run on a specific platform:

npm run android
npm run ios
npm run web

Development Tools

Run linting:

npm run lint

Run the mock API server:

npm run fake-server

The mock server runs from fake_data.json on:

http://localhost:3010

Project Structure

app/            Expo Router screens and routes
components/     Reusable UI components
assets/         Images, fonts, and static assets
scripts/        Project utility scripts

Future Improvements

  • Connect all mock data to the production backend
  • Expand interactive trade simulations
  • Add saved career pathways and progress tracking
  • Improve accessibility testing
  • Add automated tests
  • Add analytics for student engagement