apitable: A TypeScript repository from rl-balaguer

✨ Quick Start

If you just want to try out APITable¹, use our cloud-hosted version at apitable.com.

If you want to demo this APITable open-source project, click here for ⚡️Gitpod Online Demo.

If you want to install APITable in your local or cloud computing environment, see 💾 Installation

If you want to set up your local development environment, read our 🧑‍💻 Developer Guide

Join Discord or Twitter to keep in touch.

🔥 Features

Realtime Collaboration	Automatic Form

API-first Panel	Unlimited cross-table links

Powerful Rows/Columns Permissions	Embed

APITable provides a range of amazing features, from the personal to the enterprise.

Advanced technology stack and open-source
- Realtime collaboration allows multiple users to edit together in real time, or simultaneously with the Operational Transformation (OT) Algorithm.
- Extremely smooth, user-friendly, super-fast database-spreadsheet interface in <canvas> Rendering Engine.
- Database native architecture: Changeset / Operation / Action / Snapshot and so on.
- 100k+ data rows with real-time collaboration.
- Full-stack API access, from Data to Metadata.
- One-direction / Bi-direction Table Link and Infinite Cross Links
- Community-friendly programming languages and framework, TypeScript (NextJS + NestJS) and Java (Spring Boot), and we are moving to Rust gradually.
Beautiful and Rich Database-Spreadsheet UI
- CRUD: Create, Read, Update, Delete the Tables, Columns, and Rows
- Fields Operations: sort, filter, grouping, hide/unhide, height setting.
- Space based: Use separated workspaces in place of App/Base-based structure, make unlimited tables link together possible.
- Dark mode and theme customization available.
- 7 View Types: Grid View (Datasheet) / Gallery View / Mindmap View / Kanban View / Full-Feature Gantt View / Calendar View
- One-click API Panel
Batteries included
- Built-in 10+ official templates.
- Robot Automation and customization available.
- BI dashboard
- One-click auto-generated form
- Shareable and embeddable page.
- Multi-language support.
- Integration with n8n.io / Zapier / Appsmith... and more.
Excellent extensibility
- Extensible Widget System with over 20 officials open-source widgets.
- Customizable Graph & Chart & Dashboard
- Customizable Data Column Types
- Customizable Formulas
- Customizable Automation Robot Actions.
Enterprise-grade permissions
- Mirror, turn a View into a mirror to implement Row Permission.
- Activate Column Permission through a very simple operation.
- Folders / Sub-Folders / Files Permission.
- Tree structure folders and customizable node (file);
- Team Management & Organization Structure.
Enterprise features:
- SAML
- Single-Sign-On (SSO)
- Audit
- Database Auto Backup
- Data Exporter
- Watermark
....

With extensible widgets and plugins, you can add more features.

💥 Use Cases

Why you must know APITable for your next software?

As super management software
- Flexible Project Management & Tasks / Issues Management.
- Marketing Lead Management.
- Most flexible and connectable CRM.
- Flexible Business Intelligence (BI).
- People-Friendly Forms and Surveys
- Flexible ERP.
- Low-code and no-code platform.
- ...and more, APITable puts 1000 softwares in your pocket.
As a visual database infrastructure
- Embed APITable into your own software UIs.
- Visual Database with REST API.
- Admin dashboard.
- Central configuration management.
- All-in-one enterprise database that connect all your software.
- ...and more, APITable connects everything.
Also, it is open source and extensible

💞 API-oriented

API UI Panel

Clicking the API button in the right corner will show the API Panel

SQL-like query

APITable will provides a Datasheet Query Language (DQL) to query your database-spreadsheet contents.

💝 Embed-friendly

Share and Embed

Share your datasheet table or folder. Embed them by copying and pasting HTML scripts.

Enterprise-ready Embedding

APITable.com provides more Enterprise-ready Embedding features for securities.

Installation

Before you begin:

A host with docker and docker-compose v2 installed.
4 CPUs/8GB RAM or more are recommended.
A bash shell with basic utilities like curl installed.
Native arm64 (apple silicon) container images is not ready yet and may cause bad performance.

To install apitable using docker compose, open your terminal and run this:

curl https://apitable.github.io/install.sh | bash

Then open http://localhost:80 in your browser to visit it. (default username admin@apitable.com and password Apitable2022)

We also provide an all-in-one image based on pm2 for demo or testing purpose (not recommended for enterprise or production usage):

sudo docker run -d -v ${PWD}/.data:/apitable -p 80:80 --name apitable apitable/all-in-one:latest

Depending on your environment, you may need to wait several minutes for all the services to start. This image is amd64 (x86_64) only, you may encounter pretty bad performance on arm64 or apple silicon.

If you want to set up your local development environment, read our 🧑‍💻 Developer Guide

🧑‍💻 Contributing

Welcome, and thank you for your interest in contributing to APITable!

In addition to writing code, there are many ways for you to contribute.

You can contribute as following:

Join and modify translations in our Crowdin Translation Project
Create Issues
Follow our Twitter
Create Documentation
Contributing Code

You can read this repository’s Contributing Guidelines to learn how to contribute.

Here's a quick guide to help you contribute to APITable.

Development environment

Learn how to set up your local environment, go to our Developer Guide.

Git workflow basic

Here's a general APITable git workflow:

Create an issue and describe features you want -> APITable issues
Fork this project -> Fork APITable project
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some features')
Publish the branch (git push origin my-new-feature)
Create a new Pull Request -> Create pull request across forks

Work conventions

APITable use these common conventions:

What's our Git branching model? Gitflow
How to collaborate on your fork projects? Github Flow
How to write good commit message? Conventional Commits
What's our changelog format? Keep Changelog
How to versioning and tagging? Semantic Versioning
What is the Java Coding Guideline? Java Coding Guideline | Intellij IDEA Plugin
What is the TypeScript Coding Guideline? -> TypeScript Style Guide | ESLint
What is the Rust Coding Guideline? -> Rust API Guidelines
What is the Architecture Overview? -> Understand APITable - Architecture Overview

Documentations

Help Center
👩‍💻 Developer Center
- 🪡 REST API Docs
- Widget SDK (Coming soon...)
- Scripting (Coming soon...)

🛣 Roadmap

Future Features

Heavy-code Interface Builder
Embeddable 3rd party documentation components
SQL-like Domain-Specific Languages
As an IdP
Advanced automation robot
Web 3 features
...

Hosted and Enterprise versions offer advanced features

As an IdP;
SAML
Single-Sign-On
Audit
Database Backup
Integrate with ChatGPT, Zapier, Slack, Google Workspace……
Watermark

For more information, please contact us at support@apitable.com.

👫 Get Involved

🌏 Why we create APITable and open-source?

We believe that Database is the cornerstone of all the software.
We believe that making a Visual Database with rich and easy user interface for everyone can reduce the difficulty of software industry and increase the world's digitalization adoption.
We believe that open-sourcing APITable work can Push Human Beings Forward.

We are hiring remotely!

We always search for good talents for APITable:

Full-stack developer: You have experience with React, NestJS, TypeScript, Spring Boot, Java, Terraform. And you like to write high quality code with clear documentation and unit tests.
Back-end developer: You have experience with NestJS, TypeScript, Spring Boot, Java, SQL, Kubernetes, Terraform. And you like to write high quality code with clear documentation and unit tests.
Front-end developer: You have experience with React, NextJS, TypeScript, WebPack. And you like to write high quality code with clear documentation and unit tests.

Regardless of time and conditions, if you want to get involved to the team of APITable, do not hesitate and send your CV to talent@apitable.com.

📺 Screenshot

🥰 License

This repository contains the source code for the Open Source edition of APITable, released under the AGPL.

If you'd like to run your own copy of APITable or contribute to development then this is the place for you.

See LICENSING for details.

If you want to use APITable online then you don't need to run this code, we offer a hosted version of the app at APITable.com which optimized for global accelerator.

Licensed with AGPL-3.0. Designed by APITable Ltd. ↩

rl-balaguer/apitable