democracy-client

DEMOCRACY Client

A mobile application that brings the German Bundestag to citizens’ smartphones, allowing them to vote on parliamentary procedures and compare their choices with official results.

Features

• Browse and search official German Bundestag procedures
• Vote on procedures as if you were a member of parliament
• Compare your voting behavior with the community and the Bundestag
• Analyze your agreement with different parties and candidates
• Receive notifications about important parliamentary activities

Technology Stack

• React Native with Expo Router
• Apollo GraphQL client
• Styled Components
• TypeScript
• Recoil and Zustand for state management
• E2E testing with Maestro
• CI/CD with GitHub Actions

Getting Started

Prerequisites

• Node.js
• pnpm package manager (v9.0.0+) - Install via corepack enable or npm install -g pnpm
• iOS development environment (for iOS)
  • Xcode
  • CocoaPods
• Android development environment (for Android)
  • Android Studio
  • Android SDK

Installation

1. Clone the repository:

   git clone https://github.com/democracy-deutschland/democracy-client.git
   cd democracy-client
   

2. Install dependencies:

   pnpm install
   

3. Generate GraphQL types:

   pnpm codegen
   

4. Start the development server:

   pnpm start
   

5. Run on specific platforms:

   pnpm ios     # Run on iOS simulator
   pnpm android # Run on Android emulator
   

Development

• Run type checking: pnpm lint:ts
• Run linter: pnpm lint
• Run doctor for Expo issues: pnpm doctor

Testing

The project uses Maestro for end-to-end testing. See Testing Documentation for more information.

Run tests with:

pnpm test:e2e          # Run all E2E tests
pnpm test:e2e:smoke    # Run smoke tests only
pnpm test:e2e:verification  # Run verification flow tests only

Deployment

This project uses fastlane for both iOS and Android deployments.

• For iOS deployment details, see iOS Deployment
• For Android deployment details, see Android Deployment

Project Structure

• src/
  • app/ - Expo Router app directory
  • components/ - Reusable components
  • screens/ - Screen components
  • api/ - API and state management
  • __generated__/ - Generated GraphQL types
  • hooks/ - Custom React hooks
  • lib/ - Utility functions
  • data/ - Static data files
  • types/ - Type definitions
  • styles/ - Theme and styling configurations
• .github/ - GitHub workflows and CI configuration
• .maestro/ - E2E tests
• deploy/ - Deployment configurations
  • android/ - Android deployment settings and fastlane setup
  • ios/ - iOS deployment settings and fastlane setup
• assets/ - Static assets

Architecture

For a detailed explanation of the application architecture, see Architecture Documentation.

License

Apache License 2.0

Contact

democracy-deutschland.de contact@democracy-deutschland.de