Skip to content

massif-press/compcon

COMP/CON

Netlify Status Discord

GitHub last commit GitHub Issues or Pull Requests GitHub Issues or Pull Requests

COMP/CON is the official digital companion for the LANCER tabletop role playing game. It provides a full suite of tools for players and game masters, from building and managing pilots and mechs to running combat encounters and campaigns.

Launch App · Report a Bug · Join the Discord · Contributing Guide


Getting Started

Prerequisites

  • Node.js >= 24
  • Yarn >= 4
  • Git with commit signing configured (SSH or GPG - enforced by pre-commit hook)

Install

git clone https://github.com/massif-press/compcon.git
cd compcon
yarn install

Run

yarn dev

The dev server is at http://localhost:5173. Service workers are disabled in development. To test PWA behavior:

yarn build && yarn preview

Scripts

Command Description
yarn dev Start development server
yarn build Type-check and build for production
yarn build-nocheck Build without TypeScript validation
yarn preview Preview the production build locally
yarn lint Run ESLint with auto-fix
yarn lint:check Check linting without modifying files
yarn format Format code with Prettier
yarn format:check Check formatting without modifying files
yarn typecheck Run vue-tsc without emitting output

Project Structure

See ARCHITECTURE.md for a detailed breakdown of the domain model, controller pattern, state management, cloud sync, and UI conventions.


Contributing

Contributions are welcome. Please read CONTRIBUTING.md before submitting a pull request - it covers branching conventions, commit format, code standards, and what kinds of PRs are in scope.


License

COMP/CON is free software released under the GNU General Public License v3.0. You are free to run, study, modify, and distribute it - derivative works must also be licensed under the GPLv3.


LANCER is published by Massif Press.

About

Digital character creator and player sheets for the LANCER TTRPG

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors

Languages