A data entry app builder that supports:
- Complex conditional logic
- Connecting to Airtable as a 3rd party data store (Google Sheets integration coming soon!)
- Read, update, and insert operations
- Python version 3.10
- Initialize your venv
python3 -m venv venv
source venv/bin/activate
- Install all requirements
pip install -r requirements.txt
- Initialize the development database
yarn db-upgrade
This will create a db.sqlite file which will be used as the database.
This is the same command to run in the future to migrate your database after it is already set up.
- Activate your Python venv, if you haven't already:
source venv/bin/activate
-
Set the
AIRTABLE_API_KEYandAIRTABLE_BASE_IDenvironment variables in a.envor.env.localfile. Follow the template given in.env.sample -
Start the API server
yarn api
This starts the API server in http://localhost:8000
The server will reload automatically upon filestystem changes.
To view the API docs, open http://localhost:8000/docs
This is the API's swagger page where you can test endpoints.
This is a basic create-react-app (CRA) application.
- Install all requirements
yarn install
- Run the app
yarn start
This runs the app in the development mode. Open http://localhost:3000 to view it in the browser. The page will reload if you make edits.
If you update any server models (in server/models) it is likely that you'll need to update the frontend types or migrate the database. Ask yourself the following:
Do your updates affect the frontend types in src/models?
If yes, then run yarn sync-types to sync the frontend and backend services. Then watch for any TypeScript errors that can help you notice what types need to be updated. A good start is to go to the model in src/models and update the frontend type to match what you wrote in the backend.
Do your updates require a database migration?
If you are updating a model that gets written to the database then it's highly likely this will require a database migration.
- Run
yarn db-new-migration "Short description of your migration"to autogenerate a migration script. - Go to
migrations/versionsand open your new migration script. Alembic (our python db migration manager) tries to autogenerate the migration code. It's generally successful with simple migrations, like adding new columns, but it doesn't know what to do for more complicated migrations that involve editing an existing column. - Verify that your auto-generated migration script is correct. Otherwise manually update.
- IMPORTANT: Remember to also implement a downgrade function. Your migration script should be written such that running upgrade, followed by downgrade, results in the original database without any loss of data.
- When ready, run
yarn db-upgradeto test your migration. Verify it works. - Run
yarn db-downgradeto test the downgrade. Verify you didn't lose any data.
If everything is good then you're ready to commit this change and submit a PR!
Whenever you update the API models in server/models.py or add a new endpoint to server/api/views.py, you should run yarn sync-types to autogenerate the TypeScript API (in src/api) so that our frontend's types are synced with the backend.
This will autogenerate a migration script to update the database. Remember to always manually check and update the script because the autogenerated code is usually only correct for simple migrations. Also remember that your downgrade function should be correct too.
Upgrades or initializes a database all the way to the latest version.
Downgrades the database by a single version.
Launches the test runner in the interactive watch mode. See the section about running tests for more information.
TODO: we need to implement tests. Currently this is a useless command.
Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed!
See the section about deployment for more information.