https://github.com/michelderu/todo-astra-jamstack-netlify
https://github.com/michelderu/todo-astra-jamstack-netlify
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/michelderu/todo-astra-jamstack-netlify
- Owner: michelderu
- License: apache-2.0
- Created: 2021-02-24T13:12:11.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-02-24T13:12:13.000Z (over 4 years ago)
- Last Synced: 2025-01-20T08:49:24.439Z (4 months ago)
- Language: JavaScript
- Size: 57.6 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# JAMStack + Netlify + Astra + Cassandra 📒
*10 minutes, Beginner, [Start Building](https://github.com/DataStax-Examples/todo-astra-jamstack-netlify#prerequisites)*
This is an example React To-Do application using a [DataStax Astra](https://astra.datastax.com/register?utm_source=devplay&utm_medium=github&utm_campaign=todo-astra-jamstack-netlify) free tier database.
## Objectives
* Provide a fullstack development example using Astra as the storage backend
## How this works
Once the Astra credentials are provided, the necessary tables are created in the database. The webservice will be available on port 8080 once the application has been deployed.
[JAMstack](https://jamstack.org/) is a big leap forward in how we can write web applications that are easy to write, deploy, scale, and also maintain. Using this approach means that newly created content is rendered from a content API, while a static render of it is being built into the site for future.
## Get Started
To build and play with this app, follow the build instructions that are located here: [https://github.com/DataStax-Examples/todo-astra-jamstack-netlify](https://github.com/DataStax-Examples/todo-astra-jamstack-netlify#prerequisites)
# Running JAMStack + Netlify + Astra + Cassandra
Follow the instructions below to get started.
## Prerequisites
Let's do some initial setup.
### DataStax Astra
1. Create a [DataStax Astra account](https://astra.datastax.com/register?utm_source=github&utm_medium=referral&utm_campaign=todo-astra-jamstack-netlify) if you don't
already have one:
2. On the home page. Locate the button **`Add Database`**
3. Pick **free plan** and a **region** close to you, click configure.
4. Define a **database name**, **keyspace name** and **credentials** (Take note of the DB Password)
5. Your Astra DB will be ready when the status will change from *`Pending`* to **`Active`** 💥💥💥
6. After your database is provisioned, head to the `Connect` screen and copy your connection
information (we'll need this later!):
### Github
1. Click `Use this template` at the top of the [GitHub Repository](https://github.com/DataStax-Examples/todo-astra-jamstack-netlify):
2. Enter a repository name and click 'Create repository from template':
3. Clone the repository:
## 🚀 Getting Started Paths:
*Make sure you've completed the [prerequisites](#prerequisites) before starting this step*
- [Running on your local machine](#running-on-your-local-machine)
- [Running on Gitpod](#running-on-gitpod)
- [Deploying to Netlify](#deploying-to-netlify)
### Running on your local machine
1. `cd` to the cloned repository, and install Node dependencies: `npm install`.
2. Populate your environment variables into a .env file
```
cp .env-template .env
```
and modify .env to include your database specific values (you can find these in the database detail screen in the Astra UI).
```
ASTRA_DB_ID=REPLACE-ME
ASTRA_DB_REGION=REPLACE-ME
ASTRA_DB_KEYSPACE=REPLACE-ME
ASTRA_DB_PASSWORD=REPLACE-ME
ASTRA_DB_USERNAME=REPLACE-ME
```
3. In the cloned repository, build the app: `npm start:dev`.
4. Open http://localhost:8080 to view your application:
### Running on Gitpod
1. Click the 'Open in Gitpod' link:
[](https://dtsx.io/3gtADSq)
2. Wait for your Gitpod workspace to start:
3. Set your Astra database details in the Gitpod terminal at the bottom of the screen:
4. Click the 'Open browser' button in the bottom right of the screen:
5. View your application:
6. 
### Deploying to Netlify
1. Click the 'Deploy to Netlify' button:
[](https://dtsx.io/2EtfGty)
2. Connect your GitHub account:
3. Fill in the Netlify environment variables with information on your Astra database:
4. Click 'Save and Deploy':
5. Wait for your app to deploy (this will take a minute or two, the screen will auto-refresh when the deployment is complete):
6. Click your Netlify app link to view your live app:
7. You've deployed your app to Netlify!
### Things to Note:
- The contents of this repo are based on [Jake's port](https://github.com/tjake/todo-astra-react-serverless/) of the [TodoMVC code](https://github.com/tastejs/todomvc/tree/master/examples/react) originally written by [Pete Hunt](https://github.com/petehunt).
- The example is modified from https://github.com/huksley/todo-react-ssr-serverless.