Coder Social home page Coder Social logo

jason-cooke / directus Goto Github PK

View Code? Open in Web Editor NEW

This project forked from directus/directus

2.0 1.0 0.0 75.31 MB

Directus 7 Suite — Future-Proof Headless CMS & API for Custom Databases

Home Page: https://directus.io

License: Other

Shell 0.14% PHP 96.52% JavaScript 0.18% CSS 0.21% HTML 0.36% TSQL 2.59%

directus's Introduction

Directus Logo

 

The All-New Directus 7
Future-Proof Headless CMS

 

The Directus 7 App has been rebuilt from the ground-up in Vue.js and decoupled from our new "versionless" API. Both can easily be customized and extended to suit your project's needs.

 

🐰 Introduction

Directus is an open-source suite of software that provides an instant API wrapper for SQL databases and an intuitive Admin App for non-technical users to manage that content. It's like a safe, friendly, and super-powered "database client" (eg: PHP-my-Admin or Sequel Pro). Created in 2004, our premium platform powers hundreds-of-thousands of data-driven applications around the world. With our JSON API, webhooks, and complete control over where and how your content is used — what will you build with Directus?

  • Directus API — Wraps any new or existing SQL database with RESTful JSON endpoints for connecting content anywhere: websites, native apps, wearables, IoT devices, kiosks, or anything else!
  • Directus Admin App — A friendly admin interface built with Vue.js that works in conjunction with our API to allow non-technical users to manage database content and digital assets.
  • Directus Suite A package that combines our API, Admin App, and all dependencies for quick and easy installation on most servers.

 

✨ Key Concepts

Database-First

Directus follows a database-first approach, storing all of your data unaltered in pure SQL databases with that can be completely customized.

Access and Optimization

Directus mirrors your actual database so it will automatically stay in sync with any changes made directly to the database! With the full power of SQL unlocked, you can:

  1. Architect your actual database with meaningful table and column names
  2. Infinitely optimize with indexing, datatypes, lengths, defaults, keys, encoding, etc
  3. Update your database schema at any point and Directus will instantly reflect changes
  4. Create, update, and delete content directly from the database

Direct Access

This database-first approach means that you have the option to completely bypass Directus if needed. Connecting your application directly to the database means Directus is completely bypassed, removing even the slightest possiblility of a bottleneck, and giving you the unbridled power of complex SQL queries.

Portability and Transparency

Directus is not a black-box system. There is nothing proprietary or opinionated about how Directus stores your content so you're never locked-in or locked out. Import existing SQL to get started quickly, and rest assured that you can also export your unaltered content as vanilla SQL at any point. You can also self-host the entire suite on your own servers if needed or use our hosted Cloud service.

Complex Relationships

Whether you need many-to-one, one-to-many, many-to-many, or something completely different... Directus has you covered. You can interrelate database fields, then fetch deeply nested data using our robust dot-notation parameters.

Simple, Modular and Extensible

We've intentionally kept our codebase as simple and lightweight as possible. Every aspect of Directus has been modularized, with many options for extending, overriding, or even bypassing the core system. Choose your auth providers, storage adapters, content interfaces, data presentation, and more. We also have webhooks, event hooks, API response filters, custom endpoints, CSS/JS override files, and much more.

Furthermore, because the codebase has been internally decoupled, Directus supports full multitenancy. You can use a single Directus App to manage multiple Directus API instances, and each API instance can manage multiple databases (projects or environments).

Internationalization and Accessibility

Directus allows you to manage multilingual content in as many languages as your project needs. And no matter what language(s) your organization requires, our Admin App supports a growing number of locales. We've also paid close attention to our Admin App's interface to ensure it is as clear and accessible as possible for all users.

 

📖 Documentation

 

🤲 Help & Resources

Technical Support

  • Community Support — For help with open-source instances please post questions with the directus tag on Stack Overflow or chat with members of our online community.
  • Premium Support — Directus Cloud customers, Patreon Sponsors, and those paying for hourly support all have access to our Live support over our Live Chat or Email.

Community

  • Slack — Come join almost a thousand members discussing the future of Directus. Our helpful members are also quick to offer advice for simple questions you may have while getting started.
  • Twitter — Follow us on Twitter to be the first to hear about product updates, see sneak peeks of new features, and vote on polls regarding the future of our platform.

GitHub Tickets

  • Reporting Bugs — If you believe you've found a bug in the Directus Core codebase, please submit new tickets to either the App or the API. For all security related issues, please chat with us directly through directus.io.
  • Requesting Features — Feature requests are managed as GitHub issues within the appropriate Directus repository. Before making a new submission, first browse existing feature requests using the enhancement label. If you find a similar request, simply vote for it using the 👍 or 👎 reactions and add any additional context in the comments. If not, add a new feature request by completing the provided template.

Online Demos

We have two online demos available so you can easily check out Directus in action. These demos are public and is therefore susceptible to trolls who think it's funny to write offensive things or change the master user password. The entire database is reset each hour to mitigate this. The login credentials for both demos: [email protected] and password

 

❤️ Supporting Directus

Directus is a GPLv3-licensed open source project with development made possible by support from our core team, contributors, and sponsors. It's not easy building premium open-source software; if you would like to help ensure Directus stays free, please consider becoming a sponsor.

Contributing

We love pull-requests! To work on Directus you'll need to install it locally from source by following the instructions below. Submit all pull-requests to the master branch of our api and app repositories.

Sponsors

RANGER Studio, Bas Jansen

Core Team


Ben Haynes

Project Lead

Rijk van Zanten

App Lead

Advisors, Sponsors, Partners, and Key Contributors

 


Directus is released under the GPLv3 license. RANGER Studio LLC owns all Directus trademarks and logos on behalf of our project's community. Copyright © 2006-2018, RANGER Studio LLC.

directus's People

Contributors

coolov avatar wellingguzman avatar freen avatar benhaynes avatar jel-massih avatar lasha avatar maxgsoulcycle avatar rijkvanzanten avatar parnas avatar mickrip avatar worksdev avatar stevepatter avatar javiercf avatar laszlokorte avatar the0neyouseek avatar nstcactus avatar danhipke avatar jasekz avatar ilama avatar arboehme avatar jwdeitch avatar jonhershon avatar idelb avatar dekyfin avatar airbenich avatar aeonzh avatar wedjaa avatar sethjgore avatar nithinga avatar martinfojtik avatar

Stargazers

Mohammed Hasanul Chowdhury avatar Abdur-Rahmaan Janhangeer avatar

Watchers

James Cloos 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.