Repository files navigation

Beacon is a frontend application designed to work seamlessly with the LIFT-backend. It provides an intuitive interface for users to interact with various data-driven components, focusing on subject and verb selection for creating statements.

• Table of Contents
• Getting Started
  • Installation
• Project Structure
• Development
  • Linting
• Deployment
  • GitHub Actions Workflow
• Configuration
• Contributing
• License

To get started with Beacon, ensure you have the following prerequisites installed:

• Node.js (LTS version recommended)
• npm (comes with Node.js)
• Deno (for backend integration)

Clone the repository and install the dependencies:

git clone https://github.com/yourusername/beacon.gitcd beaconnpm install

This project follows a feature-based architecture to ensure maintainability and separation of concerns:

src/├── assets/             # Images and static assets├── components/         # Shared UI components│   ├── ui/             # Base UI components (buttons, inputs, etc.)│   ├── modals/         # Modal dialogs│   └── shared/         # Other shared components├── config/             # Application configuration├── data/               # Static data files (JSON, etc.)├── features/           # Feature-specific code│   ├── auth/           # Authentication feature│   ├── email/          # Email-related functionality│   ├── questions/      # Questions management│   ├── statements/     # Statements management│   └── wizard/         # Statement wizard feature├── layouts/            # Layout components├── lib/                # Shared utilities│   └── utils/          # Utility functions├── providers/          # Context providers├── routes/             # Route definitions└── types/              # TypeScript type definitions

Each feature has its own directory with components, hooks, context, and API calls, enabling better separation of concerns and improved maintainability.

SeeMIGRATION_GUIDE.md for details on the project structure organization.

To start the development server, run:

npm run dev

This will start a local server athttp://localhost:3000 where you can view the application.

Ensure your code adheres to the project's style guidelines by running:

npm run lint

Beacon is configured to deploy to Deno Deploy. The deployment process is automated using GitHub Actions. On every push to themain branch, the application is built and deployed.

The deployment workflow is defined in.github/workflows/deploy.yml. It includes steps to:

• Clone the repository
• Install Deno and Node.js
• Build the project
• Deploy to Deno

Configuration settings are managed through environment variables. Ensure you have a.env.development file in the root directory with the necessary variables:

VITE_API_URL=<your_backend_api_url>

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Commit your changes (git commit -am 'Add new feature').
4. Push to the branch (git push origin feature/your-feature).
5. Create a new Pull Request.

This project is licensed under the MIT License. See theLICENSE file for details.