Skip to content

ADifferentLuke/Gstep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gstep

Gstep is an interactive application for stepping through genome strings generated by the Genetics project.


🧬 Overview

Gstep visualizes and simulates genetic ecosystems in real time, allowing users to explore how virtual organisms behave within a digital terrain.


🚀 Running the Application

Option 1: Run from the released JAR

  1. Download the latest release from the repository’s Releases page.
  2. Run the JAR file:
    java -jar Gstep-<version>.jar
  3. Open your browser and visit:
    http://localhost:8080/
    

Option 2: Run from Source

To build and run the application manually:

  1. Build the backend with Maven:
    mvn clean install
  2. Use NPM scripts for frontend development:
    • Start the entire stack (frontend + backend):
      npm run dev:both
    • Run just the frontend:
      npm run dev
    • Build the frontend for production:
      npm run build
    • If you encounter issues:
      npm run clean:frontend && npm --prefix src/main/frontend install

🌱 Sample Genome

Example configuration for testing:

  • Environment: SeededFlatFlora
  • Genome String:
    PLANT:bdb879c89d5cbd27c01e10bd950237091ca426ef025701d5158f07ae80f11f8f0e7e770d794be34453213b1cb838c8fb6df4dde5e0449aaf3bb7091b9742b9cd8c3bef606c350c2416adbaeb35d8f9d2
    

🧠 Notes

  • The backend runs on Spring Boot and serves the React frontend from /.
  • Default server port: 8080.
  • Once the JAR is built, everything (backend + frontend) is self-contained.

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.


🧩 Related Projects

  • Genetics: The genome simulation engine powering Gstep.

About

Spring Boot + React for stepping Genetic algorithm's genomes

Resources

License

Stars

Watchers

Forks

Packages