Giter VIP home page Giter VIP logo

dndtracker's Introduction

DnDTracker

CSCE 3444 Team Name: Silicon Valley

Read our Project Description.

master
Build Status

develop
Build Status

DnDTracker is a campaign utility and data tracker for Dungeons and Dragons.

You can find master live here and develop here.

Here's what it does:

  1. Persists information about your current and past campaigns in a database.
  2. Provides the Dungeon Master with an interface of the campaign's current state and event log.
  3. Provides the players with an interface of their character's and campaign's current state.
  4. Allows the Dungeon Master to modify the characters' states.
  5. Authenticates users through Google's Auth API.

This code is open-source and under the MIT License.

Contributors

itsmistad - Derek Williamson

tylercarey98 - Tyler Carey

nathanielduncan - Nathan Duncan

andrewschlein - Andrew Schlein

Development

Requirements

  1. bash (packaged with git and cmder)
  2. Node.js
  3. aws cli
  4. dynamodb-local
  5. NUnit3 Adapter
  6. .NET Core 2.2 Runtime and SDK
  7. Java

Setup

DynamoDb

From within /scripts, run this within bash to install the admin panel:

./install-dynamodb-admin.sh

Extract dynamodb-local to ./scripts/dynamodb. Then, run this to start your local DynamoDb instance:

./start-dynamodb.sh

Run this to start your admin panel:

./start-dynamodb-admin.sh

Finally, run this to setup your local database:

./run-migrations.sh (timestamp)

timestamp is optional. If one isn't specified, all migrations will run. Do not specify a timestamp if you don't know what you're doing.

Testing

From the base directory of the repo, run this to execute all unit tests:

dotnet test

Alternatively, you can run the tests from within Visual Studio:

screenshot of right click on test project hovering over run tests option

Building and Running

Run this to download the packages and build the app:

dotnet build -c Release

Then, run this to start it:

dotnet ./src/DnDTracker.Web/bin/Release/netcoreapp2.2/DnDTracker.Web.dll

Alternatively, you could just use Visual Studio ๐Ÿ˜‰

Publishing

This script requires the bash zip command. This is natively available in unix environments, but not on Windows. You can download it here.

You can create an AWS ElasticBeanstalk-ready zip file by running this command in ./scripts AFTER adding credentials to the script file:

./create-deployable.sh

This will create a deploy directory with a deployables subdirectory.

dndtracker-app.zip is the compiled application. deploy.zip is the ElasticBeanstalk-ready deployable.

Please read the comments in the script before running.

dndtracker's People

Contributors

andrewschlein avatar csce34442019 avatar itsmistad avatar nathanielduncan avatar tylercarey98 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.