Code Monkey home page Code Monkey logo

nine-yards's Introduction

fern

Nine Yards

Nine Yards (As in "going the whole nine yards") is a self hosted, free, and open source team and project management tool. Like Trello or Asana, just you don't spend your life savings on the utilities your team wants, needs and everything in between.


Why Nine Yards

fern

TODO


Getting started with Nine Yards

fern

Nine Yards can be run in multiple configurations so you'll need to make some choices before getting started.

If you don't already have an idea of where you can host your own Nine Yards instance look here.

Picking a database

Nine Yards fully supports both SQLite and Postgres functionality wise you'll see no difference. By default SQLite is used for ease of setup but if you are expecting many concurrent users often, or or any other reason, you may want to use postgres instead.

Hosting the site

Nine Yards' front end can either be served statically from the backend or can be ran seperately allowing server side rendering to be utilised. If you dont have multiple servers it's likely best to serve the site statically; although, you can run both concurrently and route incoming traffic using software like Nginx as a reverse proxy.

Using Docker (Reccomended)

TODO

Building From Source

fern

To build Nine Yards from source you need some tools first. For the backend install Rust through Rustup and for the front end Node.js aswell as pnpm which can be installed using npm, which is bundled with Node.js.

Getting the source

# Clone this repository
git clone https://github.com/Rabbitminers/Nine-Yards
cd Nine-Yards

Building the project

# This may take some time as all dependencies need to be downloaded and compiled

# Build everything
make build

# or

# Build only the frontend site
make build-frontend

# Build only the backend
make build-backend

Running Nine Yards

# Make sure to configure your instance first
make run

What if I don't have a server?

fern

There are many great options for hosting Nine Yards both cloud and localy. If you are looking for something free, Oracle Web Infrastructure's free trial is permanent and more than powerful enough' a full specification list can be found here.

As well as this, they offer splitting your resources between multiple instances, which can be useful if you are intending on running Nine Yards split, allowing you to take advantage of server side rendering, to improve site performance and allowing for the front end and backend to be scaled seperately with minimal difficulty if needed.


Tech Stack

fern

For contributors or anyone interrested in how Nine Yards works:


Want Help?

fern

Have an issue, a feature requst or just want to ask a question? You can contact us over email, here on github or on discord in the server below

Discord

You can find the API Documentation through the OpenAPI spec here. Alternatively if enabled you can view the spec through Swagger UI on the /swagger-ui endpoint of your instance.


Licenses

Nine Yards is free and open source, and is licensed under GNU GPLv3 a summary of what this means can be found here.

nine-yards's People

Contributors

rabbitminers avatar

Stargazers

 avatar

Watchers

 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.